Replace loader for Webpack
Perform replacements (plain and regular expression) in the contents loaded by the loader.
$ npm install --save-dev string-replace-loaderWith release of 2.0.0 the loader is expected to be used in Node v4+ environment. Support for Node v3 and lower was dropped, but you can install and use the loader version of 1.3.0 in older environments.
In general, loader allows to perform replacements in a way String.prototype.replace() does (loader uses it internally).
For instance, it means that if you want to replace all occurrences, you should use RegExp-like string in query.search with g flag in query.flags, etc.
In your webpack.config.js:
module.exports = {
// ...
module: {
loaders: [
{
test: /fileInWhichJQueryIsUndefined\.js$/,
loader: 'string-replace-loader',
query: {
search: 'jQuery',
replace: 'window.$'
}
}
]
}
}To achieve regular expression replacement you should specify the flags query param
(as an empty string if you do not want any flags). In this case, search and flags are being
passed to the RegExp constructor.
In your webpack.config.js:
module.exports = {
// ...
module: {
loaders: [
{
test: /fileInWhichJQueryIsUndefined\.js$/,
loader: 'string-replace-loader',
query: {
search: 'jquery',
replace: 'window.$',
flags: 'i'
}
}
]
}
}Also, you can pass an array of search-replace pairs this way:
In your webpack.config.js:
module.exports = {
// ...
module: {
loaders: [
{
test: /\.js$/,
loader: 'string-replace-loader',
query: {
multiple: [
{ search: 'jQuery', replace: 'window.$' },
{ search: '_', replace: 'window.lodash' }
]
}
}
]
}
}You can set strict mode to ensure that the replacement was done:
In your webpack.config.js:
module.exports = {
// ...
module: {
loaders: [
{
test: /fileInWhichJQueryIsUndefined\.js$/,
loader: 'string-replace-loader',
query: {
search: 'jQuery',
replace: 'window.$',
strict: true
}
}
]
}
}Feel free to open issues to propose stuff and participate. Pull requests are also welcome.