Bundle JavaScript things with Browserify. A cascading configurable gulp recipe for gulp-chef.
$ npm install --save-dev "gulpjs/gulp#4.0" gulp-chef gulp-ccr-browserifybrowserify
Options for all bundles.
See browserify documentation for all options.
The directory that browserify starts bundling from for filenames that start with.
Sets the list of built-ins to use, which by default is set in lib/builtins.js in this distribution.
Type: array of string.
Boolean option to set if external modules should be bundled. Defaults to true.
Type: boolean
Default: true
Sets the algorithm used to parse out the common paths. Use false to turn this off, otherwise it uses the commondir module.
Type: string or boolean
Scan all files for process, global, __filename, and __dirname, defining as necessary. With this option npm modules are more likely to work but bundling takes longer. Default true.
Type: boolean
Default: true
Prevent the module name or file at file from showing up in the output bundle.
Alias: excludes
Type: array of string
An array of optional extra extensions for the module lookup machinery to use when the extension has not been specified. By default browserify considers only .js and .json files in such cases.
Alias: extension
Type: array of string
Prevent the module or bundle from being loaded into the current bundle, instead referencing from another bundle.
Alias: externals Type: array of string, or array of the object with properties:
{
basedir: {
type: 'path'
},
file: {
type: 'string'
}
}Defaults to require in expose mode but you can use another name.
Type: string
Default: 'require'
Disables converting module ids into numerical indexes. This is useful for preserving the original paths that a bundle was generated with.
Prevent the module name or file at file from showing up in the output bundle.
Alias: ignores
Type: array of string
Insert process, global, __filename, and __dirname without analyzing the AST for faster builds but larger output bundles. Default false.
Type: boolean
Default: false
Override the default inserted variables, or set insertGlobalVars[name] to undefined to not insert a variable which would otherwise be inserted.
An array which will skip all requires and global parsing for each file in the array. Use this for giant libs like jQuery or threejs that don't have any requires or node-style globals but take forever to parse.
Alias: noparse
An array of directories that browserify searches when looking for modules which are not referenced using relative path. Can be absolute or relative to basedir.
Alias: path
Type: array of string
Register plugins.
Alias: plugins
Type: array of string
Make module available from outside the bundle. The module name is anything that can be resolved by require.resolve(). Use an object with file and expose property to specify a custom dependency name. { file: './vendor/angular/angular.js', options: { expose: 'angular' } } enables require('angular').
Alias: requires
Type: array of string, or object with the following properties:
{
file: {
type: 'string'
},
options: {
basedir: {
description: 'The directory that starts searching from for filenames that start with.',
type: 'path'
},
entry: {
description: 'Make the module an entry.',
type: 'boolean',
default: false
},
expose: {
description: 'Specify a custom dependency name for the module.',
type: 'string'
},
external: {
note: 'Distingish this option with browserify.external().',
description: 'Prevent the module from being loaded into the current bundle, instead referencing from another bundle.',
type: 'boolean',
default: false
},
transform: {
note: 'Distingish this option with browserify.option.transform.',
description: 'Allow the module to be transformed.',
type: 'boolean',
default: true
}
}
}Add a source map inline to the end of the bundle or separate source map to external file. This makes debugging easier because you can see all the original files if you are in a modern enough browser.
Alias: sourcemap
Type: string or boolean
Create a standalone module with this given name and a umd wrapper. You can use namespaces in the standalone global export using a . in the string name as a separator, for example A.B.C. The global export will be sanitized and camel cased.
Type: string
Alias: transforms
Register transforms.
Type: array of string
Type: boolean or object with the following properties:
{
mangle: {
description: 'Pass false to skip mangling names.',
type: 'boolean',
default: true
},
output: {
description: 'Pass an object if you wish to specify additional output options. The defaults are optimized for best compression.',
sequences: {
description: 'Join consecutive statemets with the "comma operator".',
type: 'boolean',
default: true
},
properties: {
description: 'Optimize property access: a["foo"] → a.foo.',
type: 'boolean',
default: true
},
dead_code: {
description: 'Discard unreachable code.',
type: 'boolean',
default: true
},
drop_debugger: {
description: 'Discard "debugger" statements.',
type: 'boolean',
default: true
},
unsafe: {
description: 'Some unsafe optimizations (see below).',
type: 'boolean',
default: false
},
conditionals: {
description: 'Optimize if-s and conditional expressions.',
type: 'boolean',
default: true
},
comparisons: {
description: 'Optimize comparisons.',
type: 'boolean',
default: true
},
evaluate: {
description: 'Evaluate constant expressions.',
type: 'boolean',
default: true
},
booleans: {
description: 'Optimize boolean expressions.',
type: 'boolean',
default: true
},
loops: {
description: 'Optimize loops.',
type: 'boolean',
default: true
},
unused: {
description: 'Drop unused variables/functions.',
type: 'boolean',
default: true
},
hoist_funs: {
description: 'Hoist function declarations.',
type: 'boolean',
default: true
},
hoist_vars: {
description: 'Hoist variable declarations.',
type: 'boolean',
default: false
},
if_return: {
description: 'Optimize if-s followed by return/continue.',
type: 'boolean',
default: true
},
join_vars: {
description: 'Join var declarations.',
type: 'boolean',
default: true
},
cascade: {
description: 'Try to cascade `right` into `left` in sequences.',
type: 'boolean',
default: true
},
side_effects: {
description: 'Drop side-effect-free statements.',
type: 'boolean',
default: true
},
warnings: {
description: 'Warn about potentially dangerous optimizations/code.',
type: 'boolean',
default: true
},
global_defs: {
description: 'Global definitions.',
type: 'array',
items: {
type: 'object'
}
}
},
preserveComments: {
description: 'A convenience option for options.output.comments. Defaults to preserving no comments.',
enum: ['all', 'license']
}
}Update any source file and your browserify bundle will be recompiled on the spot. Options are passed to watchify.
Bundle or array of bundles.
Alias: bundle
String, or array of strings. Specifying entry file(s).
The name of file to write to disk.
Options for this bundle. Accepts any values in config.options.
var gulp = require('gulp');
var chef = require('gulp-chef');
var meals = chef({
src: 'src/',
dest: 'dist/',
browserify: {
bundles: [{
entries: [
'services.ts'
],
uglify: true
}, {
entries: [
'main.ts'
],
sourcemaps: '.'
}],
options: {
transforms: ['tsify']
}
}
});
gulp.registry(meals);