README.md

grunt-asset-cachebuster

Cachebust images, scripts and other assets in your HTML & CSS files.

Getting Started

This plugin requires Grunt >=0.4.0

If you haven't used Grunt before, be sure to check out the Getting Started guide, as it explains how to create a Gruntfile as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command:

npm install grunt-asset-cachebuster --save-dev

Once the plugin has been installed, it may be enabled inside your Gruntfile with this line of JavaScript:

grunt.loadNpmTasks('grunt-asset-cachebuster');

The asset_cachebuster task

Overview

In your project's Gruntfile, add a section named asset_cachebuster to the data object passed into grunt.initConfig().

Options

options.buster

Type: String | Function
Default value: '123456'

A string value that is used to append to the url of your assets.
If it is a function, the function is called with the url and the extension of a file to cachebust as parameters, and it must return a string.
Generally, you want this to be a timestamp or the version number of your app.

options.htmlExtension

Type: String
Default value: 'html'

The extension of html assets. This is useful if you use a templating language
for your html where you want to cachebust assets, i.e. 'handlebars'

options.ignore

Type: Array
Default value: []

Array of strings that if found in the url are not busted. This is useful if
you have some assets on CDNs or in a particular folder that are never changed
and hence should not be cachebusted.