html-string-replace-webpack-plugin

webpack html string replacement plugin


Keywords
webpack, plugin, string, replace
License
ISC
Install
npm install html-string-replace-webpack-plugin@1.0.0

Documentation

HTML STRING REPLACE WEBPACK PLUGIN

This is a webpack plugin that replace string in html files that created by html-webpack-plugin.
This is especially useful for adding some cdn prefix.

Installation

Install the plugin with npm:

$ npm install html-string-replace-webpack-plugin --save-dev

Basic Usage

Add plugin to webpack config plugins. And pass options.

var HtmlStringReplace = require('html-string-replace-webpack-plugin');
var webpackConfig = {
    entry: 'index.js',
    output: {
        path: 'dist',
        filename: 'index_bundle.js'
    },
    plugins: [
        new HtmlWebpackPlugin(),
        new HtmlStringReplace({
            enable: true,
            patterns: [
                {
                    match: /href/g,
                    replacement: function (match) {
                        return match;
                    }
                },
            ]
        })
    ]
};

Configuration

You can pass a hash of configuration options to HtmlStringReplace.
Allowed values are as follows:

  • enable: true | false whether enable this plugin or not.
  • patterns: add some patterns and how to replace the string.
  • patterns[parrern].replacement standard ECMAScript replace function or string

example:

new HtmlStringReplace({
    enable: true,
    patterns: [
        {
            // eg.
            // <link href="build.css">  =>
            // <link href="//cdn.baidu.com/static/build.css"> 
            match: /href=\"([^\"]*)\"/g,
            replacement: function (match, $1) {
                return 'href="' + CDN_PREFIX + $1 + '"';
            }
        },
        {
            // eg.
            // <script src="build.js">  =>
            // <script src="//cdn.baidu.com/static/build.js"> 
            match: /src=\"([^\"]*)\"/g,
            replacement: 'href="' + CDN_PREFIX + '$1"'
    ]
})