Webpack Browser Plugin
This plugin enables your webpack builds to automatically launch it's application on a browser.
Will automatically work for webpack-dev-server. For standard webpack usage -- browser sync is used to launch the application on a specific port.
Installation
npm install --save-dev webpack-browser-plugin
Setup
In webpack.config.js
:
const WebpackBrowserPlugin = ; moduleexports = ... ... plugins: ...
Example
You can specify a port and a browser to be used.
const WebpackBrowserPlugin = ; var plugins = ; plugins; var config = entry: app: __dirname + 'src/pantera.js' output: path: __dirname + 'dest' devServer: contentBase: __dirname + 'dest' plugins: plugins module: loaders: test: /\.js$/ loaders: 'babel' test: /\.scss$/ loader: 'style!css!scss?' test: /\.html$/ loader: 'html-loader' moduleexports = config;
Note: For webpack
, browser-sync
is being used. For webpack-dev-server
a child process spawns the browser popup.
Also ports get overwritten if specified in webpack.config.js for webpack-dev-server.
Other Webpack Plugins
Also checkout our other webpack plugin WebpackShellPlugin.
API
port
: Port to run on. Default: 8080browser
: Browser to use. Note: webpack-dev-server will open your default browser. Default: default <string|array>url
: Url to use. Default: http://127.0.0.1 or http://localhostpublicPath
: Public url path. Note: this gets overridden by output.publicPath in your webpack.config. Default: null
Webpack-dev-server only
openOptions
: For webpack-dev-server, we use node module opn. WARNING: This will override this plugin and webpack's configurations. Default: null
Webpack only
bsOptions
: Options to pass to the browser-sync module. WARNING: This will override this plugin and webpack's configurations. Default: null
Contributing
Create a new branch and write your changes in the src/
folder.
Make sure you run your tests with both webpack
and webpack-dev-server
. Or npm run test
and npm run test:dev
.
Once complete run npm run build
and create your pull request.