replace-regex 📂

📂 TS compatible modern nodeJS find-and-replace in files with Regex & Glob support.

npm i replace-regex

Features

• Glob Support: Use glob patterns to specify files.
• Regex Support: Replace text using regular expressions.
• Dry Run: Preview changes without modifying files.
• Count: Count matches and replacements.
• Customizable: Pass custom options to fine-tune behavior.

Usage

Basic Usage

1import { replaceRegex } from 'replace-regex'
2
3const results = await replaceRegex({
4  files: 'src/**/*.js',
5  from: /foo/g,
6  to: 'bar',
7  dry: false,
8})
9
10console.log(results)

CLI Usage

You can use the replace-regex CLI to find and replace text in files using regular expressions right from the terminal.

1Usage
2  $ replace-regex <files…>
3
4Options
5  --from            Regex pattern or string to find (Can be set multiple times)
6  --to              Replacement string or function (Required)
7  --dry             Dry run (do not actually replace, just show what would be replaced)
8  --no-glob         Disable globbing
9  --ignore          Ignore files matching this pattern (Can be set multiple times)
10  --ignore-case     Search case-insensitively
11
12Examples
13  $ replace-regex --from='fox' --to='🦊' foo.md
14  $ replace-regex --from='v\\d+\\.\\d+\\.\\d+' --to='v$npm_package_version' foo.css
15  $ replace-regex --from='blob' --to='blog' 'some/**/[gb]lob/*' '!some/glob/foo'

Options

• files (string or string[]): Glob patterns or file paths to process.
• from (string | RegExp | (file: string) => string | RegExp): The pattern to search for.
• to (string | (match: string, file: string) => string): The replacement string or function.
• dry (boolean, optional): If true, no files will be overwritten. Default is false.
• ignore (string[], optional): An array of glob patterns to exclude matches.
• disableGlobs (boolean, optional): If true, disables glob pattern matching. Default is false.
• fastGlobOptions (object, optional): Options to pass to fast-glob.

CLI Examples

To replace all occurrences of the word fox with 🦊 in the file foo.md:

1replace-regex --from='fox' --to='🦊' foo.md

To replace version numbers in a CSS file with the version from your package.json:

1replace-regex --from='v\\d+\\.\\d+\\.\\d+' --to='v$npm_package_version' foo.css

To replace the word blob with blog in files matching a glob pattern, while ignoring certain files:

1replace-regex --from='blob' --to='blog' 'some/**/[gb]lob/*' '!some/glob/foo'

To perform a dry run (no files will be overwritten):

1replace-regex --from='fox' --to='🦊' --dry foo.md

To perform a case-insensitive search and replace:

1replace-regex --from='fox' --to='🦊' --ignore-case foo.md

API Examples

Replace text in JavaScript files

1replaceRegex({
2  files: 'src/**/*.js',
3  from: /console\.log/g,
4  to: 'logger.log',
5  dry: false,
6})

Dry Run

1const result = await replaceRegex({
2  files: 'src/**/*.js',
3  from: /foo/g,
4  to: 'bar',
5  dry: true, // No files will be overwritten
6})
7
8console.log(`result → `, result)

Custom Replacement Function

1replaceRegex({
2  files: 'src/**/*.js',
3  from: /foo/g,
4  to: (match, file) => `${match.toUpperCase()} in ${file}`,
5  dry: false,
6})