百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
W

webpack-chrome-extension-reloader

> 编程语言
开源

在使用 webpack 开发 Chrome 扩展时进行热加载

377 stars0 点赞0 次浏览
访问官网GitHub

工具介绍

在使用 webpack 开发 Chrome 扩展时进行热加载

Disclaimer

This repository and package are archived, for now on it's recommended to use webpack-extension-reloader

Webpack Chrome Extension Reloader

A Webpack plugin to enable hot reloading while developing Chrome extensions.

Installing

npm

bash
npm install webpack-chrome-extension-reloader --save-dev

yarn

bash
yarn add webpack-chrome-extension-reloader --dev

Solution for ...

Have your ever being annoyed while developing a Google Chrome extension, and being unable to use webpack-hot-server because it's not a web app but a browser extension?

Well, now you can do hot reloading!

What it does?

Basically something similar to what the webpack hot reload middleware does. When you change the code and the webpack trigger and finish the compilation, your extension is notified and then reloaded using the chrome.runtime API. Check out Hot reloading Chrome extensions using Webpack for more background.

How to use

Using as a plugin

Add webpack-chrome-extension-reloader to the plugins section of your webpack configuration file.

javascript
const ChromeExtensionReloader  = require('webpack-chrome-extension-reloader');

plugins: [
    new ChromeExtensionReloader()
]

You can also set some options (the following are the default ones):

…

And then just run your application with Webpack in watch mode:

bash
NODE_ENV=development webpack --config myconfig.js --mode=development --watch 

Important: You need to set --mode=development to activate the plugin (only if you didn't set on the webpack.config.js already) then you need to run with --watch, as the plugin will be able to sign the extension only if webpack triggers the rebuild (again, only if you didn't set on webpack.config).

Multiple Content Script support

If you use more than one content script in your extension, like:

javascript
entry: {
    'my-first-content-script': './my-first-content-script.js',
    'my-second-content-script': './my-second-content-script.js',
    // and so on ...
    background: './my-background-script.js'
}

You can use the entries.contentScript options as an array:

javascript
plugins: [
    new ChromeExtensionReloader({
      entries: { 
        contentScript: ['my-first-content-script', 'my-second-content-script', /* and so on ... */],
        background: 'background'
      }
    })
]

CLI

If you don't want all the plugin setup, you can just use the client that comes with the package.
You can use by intalling the package globably, or directly using npx after installing locally the plugin:

bash
npx wcer

If you run directly, it will use the default configurations, but if you want to customize you can call it with the following options:

bash
npx wcer --config wb.config.js --port 9080 --no-page-reload --content-script my-content.js --background bg.js 

If you have multiple content scripts, just use comma (with no spaces) while passing the option

bash
npx wcer --content-script my-first-content.js,my-second-content.js,my-third-content.js 

Client options

name default description
--help Shows this help
--config webpack.config.js The webpack configuration file path
--port 9090 The port to run the server
--content-script content-script The entry/entries name(s) for the content script(s)
--background background The entry name for the background script
--no-page-reload Disable the auto reloading of all pages which runs the plugin

Every time webpack triggers a compilation, the extension reloader are going to do the hot reload :)
Note: the plugin only works on development mode, so don't forget to set the NODE_ENV before run the command above

Contributing

Please before opening any issue or pull request check the contribution guide.

Building and Testing

Inside this repository have an example plugin, so you can test and see it working After clone the repo, run:

bash
yarn build

And then run:

bash
yarn sample

This will make the webpack run in watch mode for the sample plugin source and output the built files on the "dist" directory. Load the extension (the files in "sample/dist" directory) in Chrome using the "load unpacked extension", open a new tab in any site and open the developer panel on it. Watch the dev. tools console tab, and do some changes on the background or content script. Voila!

Note: You must have both background and content scripts for this plugin to work, and they must be specified in separate entry chunks in your webpack config.

The reloading script will be injected only on the main entries chunks (in background and content script). Any other chunks will be ignored.

License

This project is under the MIT LICENSE

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

TypeScriptchrome-extensionshot-reloadingwebpackwebpack-plugin

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言