README

esbuild-plugin-text-replace

Replace content before bundling with support for Filefilter, Namespace and Regex.

Install

$ npm install --save-dev esbuild-plugin-text-replace

Hint: Node >=10.1.0 for fs.promise

Usage

import esbuild from 'esbuild'
import textReplace from 'esbuild-plugin-text-replace'

await esbuild.build(
    {
        entryPoints: ['./test-build-input'],
        outfile: 'test-build-out.js',
        plugins: [
            
            textReplace(
                {
                    include: /mypackage\/dist/loader\.js$\/,
                    pattern:[
                        ['const installRetry','let installRetry'],
                        [/const\s+{\s*textReplace\s*}\s*=\s*require\s*\(\s*'esbuild-plugin-text-replace'\s*\)\s*;/g , "'import textReplace from 'esbuild-plugin-text-replace'"]
                    ]
                }
            )
        ],
    }
)

Options

`include`

Filter filepath by regex.

Type: RegExp Default: /.*/

Note: Try to never use the default value as this is has a huge impact on speed if all files are matched!

`namespace`

Type: String Default: all

More info about esbuild namespaces

`pattern`

Search with Text or Regex and replace the found content with a string.

Type: Array Default: []

All information about the replaceAll regex Options and replacer functions.

Examples:

[
    // transform 2020-10-02 to 02.10.2020
    [/(\d{4})-(\d{2})-(\d{2})/g , (match,p1,p2,p3,offset,wholeString)=>`${p3}.${p2}.${p1}`], 
    ['__buildVersion' , '"1.1.1"'],
    [/(\s*)const(\s+a\s*=\s*1[\s;\n])/g, '$1let$2']
]

Note: /g for globale replacement is a must requirement

Roadmap

tests
speed tests

Contribution

Contributions are what make the open source community such an amazing place to be learn, inspire, and create. Any contributions you make are greatly appreciated.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

Built With

microbundle

License

Distributed under the "bsd-2-clause" License. See LICENSE.txt for more information.

Usage no npm install needed!