Scroll to navigation

BROWSERIFY(1) browserify BROWSERIFY(1)

NAME

browserify - browserify Node.js sources

SYNOPSIS

browserify [entry files] {OPTIONS}

DESCRIPTION

Browsers don't have the require method defined, but Node.js does. With Browserify you can write code that uses require in the same way that you would use it in Node.

OPTIONS

Standard Options:

Write the browserify bundle to this file. If unspecified, browserify prints to stdout.
A module name or file to bundle.require() Optionally use a colon separator to set the target.
An entry point of your app
Replace a file with an empty stub. Files can be globs.
Omit a file from the output bundle. Files can be globs.
Reference a file from another bundle. Files can be globs.
Use a transform module on top-level files.
Use a transform command on top-level files.
Generate a UMD bundle for the supplied export name. This bundle works with other module systems and sets the name given as a window global if no module system is found.
Enable source maps that allow you to debug your files separately.
Show this message

For advanced options, type `browserify --help advanced`.

Specify a parameter.

Advanced Options

[default: false]
Skip detection and always insert definitions for process, global, __filename, and __dirname.
benefit: faster builds cost: extra bytes

--insert-global-vars, --igv

Comma-separated list of global variables to detect and define. Default: __filename,__dirname,process,Buffer,global
[default: true]
Detect the presence of process, global, __filename, and __dirname and define these values when present.
benefit: npm modules more likely to work cost: slower builds
[default: false]
Ignore `require()` statements that don't resolve to anything.

--noparse=FILE

Don't parse FILE at all. This will make bundling much, much faster for giant libs like jquery or threejs.

--no-builtins

Turn off builtins. This is handy when you want to run a bundle in node which provides the core builtins.

--no-commondir

Turn off setting a commondir. This is useful if you want to preserve the original paths that a bundle was generated with.

--no-bundle-external

Turn off bundling of all external modules. This is useful if you only want to bundle your local files.

--bare

Alias for both --no-builtins, --no-commondir, and sets --insert-global-vars to just "__filename,__dirname". This is handy if you want to run bundles in node.

--no-browser-field, --no-bf

Turn off package.json browser field resolution. This is also handy if you need to run a bundle in node.

--transform-key

Instead of the default package.json#browserify#transform field to list all transforms to apply when running browserify, a custom field, like, e.g. package.json#browserify#production or package.json#browserify#staging can be used, by for example running: * `browserify index.js --transform-key=production > bundle.js` * `browserify index.js --transform-key=staging > bundle.js`

--node

Alias for --bare and --no-browser-field.

--full-paths

Turn off converting module ids into numerical indexes. This is useful for preserving the original paths that a bundle was generated with.

--deps

Instead of standard bundle output, print the dependency array generated by module-deps.

--no-dedupe

Turn off deduping.

--list

Print each file in the dependency graph. Useful for makefiles.

--extension=EXTENSION

Consider files with specified EXTENSION as modules, this option can used multiple times.

--global-transform=MODULE, -g MODULE

Use a transform module on all files after any ordinary transforms have run.

--plugin=MODULE, -p MODULE

Register MODULE as a plugin.

--preserve-symlinks

Preserves symlinks when resolving modules.

Passing arguments to transforms and plugins:

For -t, -g, and -p, you may use subarg syntax to pass options to the transforms or plugin function as the second parameter. For example:

-t [ foo -x 3 --beep ]

will call the `foo` transform for each applicable file by calling:
foo(file, { x: 3, beep: true })

SEE ALSO

browser-pack(1)

September 2021 browserify 17.0.0