Webpack plugin: replace-hash-in-file-webpack-plugin

This is a webpack plugin that can replace content in file(s) after compilation is done. This is useful when you want to replace content in any kind of files(html, css, js etc) which are not processed by loaders.

Use [hash] to insert the compilation hash into the search and replace when it is a string or a method returning a string i.e. not a regex.

This is heavily based off replace-in-file-webpack-plugin

Installation

Install the plugin with npm:

1$ npm install replace-hash-in-file-webpack-plugin --save-dev

Basic Usage

Add the plugin to your webpack and config as follows:

1    const ReplaceHashInFileWebpackPlugin = require('replace-hash-in-file-webpack-plugin');
2    const webpackConfig = {
3        entry: 'index.js',
4        output: {
5            path: __dirname + '/dist',
6            filename: 'index_bundle.js'
7        },
8        plugins: [
9            new ReplaceHashInFileWebpackPlugin([{
10                dir: 'dist',
11                files: ['index.html', 'main.html'],
12                rules: [{
13                    search: /js\/bundle\.*[a-zA-Z0-9]*\.js/,
14                    replace: 'js/bundle.[hash].js'
15                },{
16                    search: /@title/,
17                    replace: 'page title!'
18                }]
19            }, {
20                dir: 'dist/style',
21                test: /\.html$/,
22                rules: [{
23                    search: /version/ig,
24                    replace: '1.0.0'
25                },{
26                    search: '@title',
27                    replace: function(match){
28
29                    }
30                }]
31            },{
32                dir: 'dist/style',
33                test: [/\.css$/, /\.txt/],
34                rules: [{
35                    search: /version/ig,
36                    replace: '1.0.0'
37                },{
38                    search: '@title',
39                    replace: 'webpack'
40                }]
41            }])
42        ]
43    };

Configuration

You can pass an array of configuration options to ReplaceHashInFileWebpackPlugin. Each configuration has following items:

• dir: Optional. Base dir to find the files, if not provided, use the root of webpack context.
• files: Optional. Files in dir to find for replacement.
• test: Optional. Regex expression or Regex expressions array to match files in dir.
• rules: Required. Replace content rules array. Each rule has search and replace properties.
• search: Required. String or Regex expression used for searching content in files - use [hash] to replace hash in string.
• replace: Required. String or funcion used for replacing the searching content - use [hash] to replace hash in string.

License

This project is licensed under MIT.