browserify-webpack-plugin
v0.5.4
Published
Simple, yet comprehensive webpack plugin to bundle almost any javascript/typescript project for modern browsers.
Downloads
16
Readme
browserify-webpack-plugin [^1]
Simple, yet comprehensive webpack plugin to bundle almost any javascript/typescript project for modern browsers.
Level of support is the union of both Webpack[^2] and Browserify[^3] shims, in addition to the following features:
- [x] Multi-threaded in-memory filesystem through wasabio.
- [x] Network-less in-browser http server through fakettp.
- [x] Dockerized and virtual child processes with brocess.
This plugin also takes care of selectively applying these shims and properly initialize their respective libraries.
Usage
This plugin uses Webpack's "Extends" feature in its configuration. This allows you more flexibility in how you configure your project.
# in your project directory
npm install --save-dev browserify-webpack-plugin
// webpack.config.js
const path = require("path");
module.exports = {
extends: require.resolve("browserify-webpack-plugin"),
mode: "development",
entry: "./index.js",
output: {
path: path.resolve(__dirname, "dist"),
filename: "bundle.js",
},
};
The plugin accepts a few command line arguments:
--env include**="<pathOrGlob>"
where**
may be optionally repeated with different values to form an array and self document what is being included next to the bundle.--env exclude**="<pathOrGlob>"
where**
may be optionally substituted just like above, these patterns will be excluded from the emitted memory asset.--env memory="<unique>"
where<unique>
ismem.zip
by default. This iswasabio
's starter memory archive.--env listen="<address>"
where<address>
islocalhost:8080
by default. This isfakettp
's starter address.--env docker="<image>"
where<image>
isLatest Debian Slim
by default. This isbrocess
's starter container.
Example invocation in your repository after extending this package in your webpack.config.js
:
# emits "mem.zip" in the output directory which includes the following globs in wasabio's memory:
webpack --env includeSrc='mods/*' --env includeIndex='index.js' --env exclude='tty.ts'
[^1]: This project is not associated with the original Browserify project. [^2]: Webpack's documented resolve fallbacks [^3]: Browserify's documented builtin transforms