Webpack content replacer

Replace content in file in webpack workflow

Edit file by replacing content at different build step in a webpack workflow.

For example, you can change text color, text content or also insert configuration values from environment variables.

Installing

1npm i webpack-content-replacer-plugin

Getting started in webpack

Require webpack-content-replacer-plugin

1var ContentReplacerWebpackPlugin = require('webpack-content-replacer-plugin')

Add the plugin to your plugin list

1var config = {
2  plugins: [
3    new ContentReplacerWebpackPlugin({
4      modifiedFile: './relative_path/file_to_be_modified.ext',
5      modifications: [
6        {
7          regex: /%content_to_be_deleted%/g,
8          modification: 'new_content',
9        },
10        {
11          regex: /%content2_to_be_deleted%/g,
12          modification: 'new_content2',
13        },
14      ],
15    })
16  ]
17}

Configuration

modifiedFile

• Type: String
• Default: no default value
• Required: true

Specify the file which will be modified.

Example:

1var config = {
2  plugins: [
3    new ContentReplacerWebpackPlugin({
4      modifiedFile: './build/index.html',
5      ...
6    })
7  ]
8}

modifications

• Type: Array<Modification>
• Default: no default value
• Required: true

Specify the modifications to be applied to the file.

Example:

1var config = {
2  plugins: [
3    new ContentReplacerWebpackPlugin({
4      modifiedFile: './build/index.html',
5      [
6        {
7          regex: /text/g,
8          modification: 'new text'
9        }
10      ],
11      ...
12    })
13  ]
14}

modification

• Type: Object
• Default: no default value
• Required: true

Example:

1{
2  regex: /text/g,
3  modification: 'new text'
4}

buildTrigger

• Type: String
• Default: after-emit
• Allowed values: after-emit, done

Specify webpack build step (c.f plugin documentation).

Example:

1var config = {
2  plugins: [
3    new ContentReplacerWebpackPlugin({
4      modifiedFile: './build/index.html',
5      [
6        {
7          regex: /text/g,
8          modification: 'new text'
9        }
10      ],
11      buildTrigger: 'done',
12      ...
13    })
14  ]
15}

logLevel

• Type: String
• Default: strict
• Allowed value: strict, log, none
  • strict: catch errors in an exception, the webpack build crashes
  • log: log errors in a log file (warning.log) and none behavior
  • none: show errors in console (when silent mode is off)

Specify behavior when the plugin fail.

Example:

1var config = {
2  plugins: [
3    new ContentReplacerWebpackPlugin({
4      modifiedFile: './build/index.html',
5      [
6        {
7          regex: /text/g,
8          modification: 'new text'
9        }
10      ],
11      buildTrigger: 'done',
12      logLevel: 'log'
13      ...
14    })
15  ]
16}

silent

• Type: Boolean
• Default: false

Display/hide info logs during the build.

Example:

1var config = {
2  plugins: [
3    new ContentReplacerWebpackPlugin({
4      silent: true,
5      modifiedFile: './build/index.html',
6      [
7        {
8          regex: /text/g,
9          modification: 'new text'
10        }
11      ],
12      buildTrigger: 'done'
13      ],
14    })
15  ]
16}

Developing

1git clone https://github.com/{your fork}/webpack-content-replacer-plugin.git
2cd webpack-content-replacer-plugin/
3npm install

Replace {your fork} by your github username.

Contributing

If you'd like to contribute, please fork the repository and use a feature branch. All contributions are welcome. Please make a pull request and make sure things still pass after running npm test. Ensure you've read the contribution guidelines for more information and respect the code of conduct

Contributors

Thanks goes to these wonderful people (emoji key):

Sebastien Correaud 🚇 💻 📖 ⚠️ 👀	YQBird 📖 ⚠️ 👀

This project follows the all-contributors specification. Contributions of any kind welcome!

Licensing

The code in this project is licensed under MIT license.