# 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](http://gruntjs.com/) before, be sure to check out the [Getting Started](http://gruntjs.com/getting-started) guide, as it explains how to create a [Gruntfile](http://gruntjs.com/sample-gruntfile) as well as install and use Grunt plugins. Once you're familiar with that process, you may install this plugin with this command: ```shell 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: ```js 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()`. ```js grunt.initConfig({ asset_cachebuster: { options: { buster: Date.now(), ignore: [], htmlExtension: 'html' }, your_target: { // Target-specific file lists and/or options go here. // make sure you have separate file lists for your CSS and HTML files } } }) ``` ### 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. ### Usage Examples #### Default Options ```js grunt.initConfig({ asset_cachebuster: { options: {}, build: { files: { 'dest/default_options.css': ['src/testing.css'], 'dest/default_options.html': ['src/testing.html'] } } } }) ``` In this example, the default options are used to cachebust html and css files. So if the `testing.css` or `testing.html` files have content such as ```css h1 { background-image: url('testing.png'); } ``` or ```html

grunt-asset-cachebuster

Downloads in past1 Month3 Months6 Months1 Year2 Years5 YearsAll time

Stats

Sick of boring JavaScript newsletters?

Downloads in past