Wondering what’s next for npm?Check out our public roadmap! »

    browserify-incremental

    3.1.1 • Public • Published

    browserify-incremental

    Incremental rebuild for browserify

    Update any source file and re-bundle, and only changed files will be parsed, so it will build super fast (even with big dependencies like React!).

    How is this different from watchify?

    browserify-incremental can detect changes which occured in between runs, which means it can be used as part of build systems which are invoked on demand, without requiring a long lived process. Whereas watchify is slow for the first run upon each startup, browserify-incremental is fast every time after the very first.

    example

    Use browserifyinc with all the same arguments as browserify, with the added --cachefile argument specifying where to put the cache file:

    $ browserifyinc -r react -o output/bundle.js  -v
    556200 bytes written to output/bundle.js (1.38 seconds)
    $ browserifyinc -r react -o output/bundle.js  -v
    556200 bytes written to output/bundle.js (0.13 seconds)
    

    Now if you change some files and rebuild, only the changed files will be parsed and the rest will reuse the previous build's cached output.

    You can use -v/--verbose to get more verbose output to show which files have changed and how long the bundling took:

    $ browserifyinc test-module/ -v -o output/bundle.js
    changed files:
    /Users/jfriend/code/browserify-incremental/example/test-module/index.js
    1000423 bytes written to output/bundle.js (0.18 seconds)
    

    If you don't specify --cachefile, a browserify-cache.json file will be created in the current working directory.

    usage

    CLI

    browserifyinc --cachefile tmp/browserify-cache.json main.js > output.js
    

    All the bundle options are the same as the browserify command except for -v and --cachefile.

    API

    var browserifyInc = require('browserify-incremental')

    var b = browserifyInc(opts)

    Create a browserify bundle b from opts.

    b is exactly like a browserify bundle except that it caches file contents and calling b.bundle() extra times past the first time will be much faster due to that caching.

    By default, when used via API, browserify-incremental will only use in-memory caching, however you can pass a cacheFile option which will use an on disk cache instead (useful for build scripts which run once and exit).

    You can also pass in a browserify instance of your own, and that will be used instead of creating a new one, however when you create your browserify instance you must include the following options:

    {cache: {}, packageCache: {}, fullPaths: true}

    For convenience, these options are available as browserifyInc.args, so you can use them like:

    var browserify = require('browserify')
    var browserifyInc = require('browserify-incremental')
    var xtend = require('xtend')
     
    var b = browserify(xtend(browserifyInc.args, {
      // your custom opts
    }))
    browserifyInc(b, {cacheFile: './browserify-cache.json'})
     
    b.bundle().pipe(process.stdout)

    The cacheFile opt can be passed to either the browserify or browserify-incremental constructor.

    events

    b.on('bytes', function (bytes) {})

    When a bundle is generated, this event fires with the number of bytes written.

    b.on('time', function (time) {})

    When a bundle is generated, this event fires with the time it took to create the bundle in milliseconds.

    b.on('log', function (msg) {})

    This event fires to with messages of the form:

    X bytes written (Y seconds)
    

    with the number of bytes in the bundle X and the time in seconds Y.

    install

    With npm do:

    $ npm install -g browserify-incremental browserify
    

    to get the browserifyinc command and:

    $ npm install --save browserify-incremental browserify
    

    to get just the library.

    Contributing

    Please see the Contributor Guidelines.

    license

    MIT

    Keywords

    none

    Install

    npm i browserify-incremental

    DownloadsWeekly Downloads

    53,905

    Version

    3.1.1

    License

    MIT

    Last publish

    Collaborators

    • avatar
    • avatar