errorify

errorify

A browserify plugin that writes the error message of a failed build to the output file, rendering it in the browser.

Example

watchify index.js -o bundle.js -p errorify

After adding the plugin to your browserify instance, errorify prevents bundle() from emitting error's. All errors are trapped, including: invalid syntax in the source, a missing dependency, a failed transform, etc. When the error message is written to the output file, it is written to the DOM in a <pre> tag (or console.error if we are not in a browser environment).

During development, it might look like this:

Only the bundle() stream is rewritten. If you pass in a callback, it'll get the expected err and body arguments.

errorify is meant to be used with something like watchify. It saves you a trip to the terminal to see why a build failed.

Keep in mind that since errors are no longer emitted, all builds appear "successful". Careful not to deploy broken code.

Note: Only tested with Browserify 9+

Usage

API

var browserify = require('browserify');
var errorify = require('errorify');
var b = browserify({ /*...*/ });
b.plugin(errorify, /* errorify options */);

Options

• replacer (optional) is a function that takes an error as its first argument, and returns a string that will be used as the output bundle.

CLI

After installing errorify as a local devDependency, you can use the --plugin or -p option like so:

watchify index.js -o bundle.js -p errorify

CSS Customization

The added <pre> tag has the class name errorify, so you can customize errors in your page like so:

body > .errorify {
  color: red;
  font-family: 'Consolas', monospace;
  padding: 5px 10px;
}

License

MIT.