Require Node.js 20

Author: sindresorhus

.github/workflows/main.yml

@@ -10,15 +10,15 @@ jobs:
       fail-fast: false
       matrix:
         node-version:
+          - 24
           - 20
-          - 18
         os:
           - ubuntu-latest
           - macos-latest
-          - windows-latest
+          # - windows-latest
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v5
+      - uses: actions/setup-node@v5
         with:
           node-version: ${{ matrix.node-version }}
       - run: npm install

api.js

@@ -35,11 +35,12 @@ const normalizeRegex = (pattern, forceIgnoreCase) => {
 };
 
 /**
- * Replace matching strings and regexes in files.
- * - If `find` is provided, `replacement` must be a string.
- * - If `transform` is provided, it runs after all find/replace operations.
- * - When `dryRun` is true, returns a list of proposed changes.
- */
+Replace matching strings and regexes in files.
+
+- If `find` is provided, `replacement` must be a string.
+- If `transform` is provided, it runs after all find/replace operations.
+- When `dryRun` is true, returns a list of proposed changes.
+*/
 export default async function replaceInFiles(
 	inputPaths,
 	{
@@ -72,6 +73,7 @@ export default async function replaceInFiles(
 	let filePaths;
 	if (glob) {
 		const patterns = filePathPatterns.map(p => normalizePath(p));
+		// TODO: Look into using built-in glob when targeting Node.js 24.
 		filePaths = await globby(patterns, {dot: true, absolute: true, expandDirectories: false});
 	} else {
 		filePaths = filePathPatterns.map(p => path.resolve(String(p)));
@@ -83,9 +85,9 @@ export default async function replaceInFiles(
 	// Replace escape sequences in replacement if we have find patterns
 	if (hasFind && typeof replacement === 'string') {
 		replacement = replacement
-			.replaceAll('\\n', '\n')
-			.replaceAll('\\r', '\r')
-			.replaceAll('\\t', '\t');
+			.replaceAll(String.raw`\n`, '\n')
+			.replaceAll(String.raw`\r`, '\r')
+			.replaceAll(String.raw`\t`, '\t');
 	}
 
 	// Prepare replacers

package.json

@@ -20,7 +20,7 @@
 	},
 	"sideEffects": false,
 	"engines": {
-		"node": ">=18"
+		"node": ">=20"
 	},
 	"scripts": {
 		"test": "xo && ava"
@@ -50,15 +50,15 @@
 	],
 	"dependencies": {
 		"escape-string-regexp": "^5.0.0",
-		"globby": "^14.0.1",
+		"globby": "^14.1.0",
 		"meow": "^13.2.0",
 		"normalize-path": "^3.0.0",
-		"write-file-atomic": "^5.0.1"
+		"write-file-atomic": "^6.0.0"
 	},
 	"devDependencies": {
-		"ava": "^6.1.3",
-		"execa": "^9.3.0",
-		"temp-write": "^5.0.0",
-		"xo": "^0.58.0"
+		"ava": "^6.4.1",
+		"execa": "^9.6.0",
+		"temp-write": "^6.0.0",
+		"xo": "^1.2.2"
 	}
 }

readme.md

@@ -40,7 +40,7 @@ Real-world use-case: [Bumping version number in a file when publishing to npm](h
 
 The regex should be [JavaScript flavor](https://www.regular-expressions.info/javascript.html).
 
-## Programmatic API
+## API
 
 You can also use this package programmatically:
 
@@ -66,8 +66,6 @@ await replaceInFiles('*.js', {
 });
 ```
 
-### Transform Option
-
 The `transform` option provides full control over file content:
 - **Standalone**: Use alone for prepend, append, or complex transformations
 - **Combined**: Use with `find`/`replacement` - transform runs after find/replace operations

test.js

@@ -13,27 +13,27 @@ test('--string', async t => {
 
 test('--regex', async t => {
 	const filePath = await tempWrite('foo bar foo');
-	await execa('./cli.js', ['--regex=\\bb.*?\\b', '--replacement=foo', filePath]);
+	await execa('./cli.js', [String.raw`--regex=\bb.*?\b`, '--replacement=foo', filePath]);
 	t.is(fs.readFileSync(filePath, 'utf8'), 'foo foo foo');
 });
 
 test('newlines and tabs', async t => {
 	const filePath = await tempWrite('a,b,c');
-	await execa('./cli.js', ['--string=,', '--replacement=\\n', filePath]);
+	await execa('./cli.js', ['--string=,', String.raw`--replacement=\n`, filePath]);
 	t.is(fs.readFileSync(filePath, 'utf8'), 'a\nb\nc');
 
 	const filePath2 = await tempWrite('a,b,c');
-	await execa('./cli.js', ['--string=,', '--replacement=\\t', filePath2]);
+	await execa('./cli.js', ['--string=,', String.raw`--replacement=\t`, filePath2]);
 	t.is(fs.readFileSync(filePath2, 'utf8'), 'a\tb\tc');
 
 	const filePath3 = await tempWrite('a,b,c');
-	await execa('./cli.js', ['--string=,', '--replacement=\\r', filePath3]);
+	await execa('./cli.js', ['--string=,', String.raw`--replacement=\r`, filePath3]);
 	t.is(fs.readFileSync(filePath3, 'utf8'), 'a\rb\rc');
 });
 
 test('multiple newlines and tabs', async t => {
 	const filePath = await tempWrite('a,b,c');
-	await execa('./cli.js', ['--string=,', '--replacement=\\n\\n\\t\\r', filePath]);
+	await execa('./cli.js', ['--string=,', String.raw`--replacement=\n\n\t\r`, filePath]);
 	t.is(fs.readFileSync(filePath, 'utf8'), 'a\n\n\t\rb\n\n\t\rc');
 });
 
@@ -84,7 +84,7 @@ test('--dry-run with no matches', async t => {
 
 test('--dry-run with regex', async t => {
 	const filePath = await tempWrite('version 1.2.3 here');
-	const {stdout} = await execa('./cli.js', ['--dry-run', '--regex=\\d+\\.\\d+\\.\\d+', '--replacement=2.0.0', filePath]);
+	const {stdout} = await execa('./cli.js', ['--dry-run', String.raw`--regex=\d+\.\d+\.\d+`, '--replacement=2.0.0', filePath]);
 
 	t.is(fs.readFileSync(filePath, 'utf8'), 'version 1.2.3 here');
 	t.true(stdout.includes('version 1.2.3 here'));