Package Exports

gulp-hash

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (gulp-hash) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

gulp-hash

Cachebust your assets by adding a hash to the filename

npm install --save-dev gulp-hash

Basic usage

var hash = require('gulp-hash');

// ...

gulp.src('./js/**/*.js')
    .pipe(hash()) // Add hashes to the files' names
    .pipe(gulp.dest('public/js')) // Write the renamed files
    .pipe(hash.manifest('assets.json')) // Switch to the manifest file
    .pipe(gulp.dest('public')); // Write the manifest file

The "manifest" is a JSON file that maps the original filenames to the renamed ones.

API

hash(options)

Option	Default	Description
algorithm	'sha1'	A hashing algorithm for crypto.createHash
hashLength	8	The length of the hash to add to the file's name (slice from the start of the full hash)
template	`'<%= name %>-<%= hash %><%= ext %>'`	The template used when adding the hash
version	''	A key to change the files' hashes without actually changing their content; appended to the contents when hashing

hash.manifest(manifestPath, append)

Option	Default	Description
manifestPath		The desired path to the manifest file
append	true	Whether to merge the new manifest with an existing one's contents (same filename, doesn't have to exist before first run)