Require Node.js 22

Author: sindresorhus

.github/workflows/main.yml

@@ -10,11 +10,11 @@ jobs:
       fail-fast: false
       matrix:
         node-version:
-          - 20
-          - 18
+          - 26
+          - 22
     steps:
-      - uses: actions/checkout@v4
-      - uses: actions/setup-node@v4
+      - uses: actions/checkout@v7
+      - uses: actions/setup-node@v6
         with:
           node-version: ${{ matrix.node-version }}
       - run: npm install

browser.js

@@ -1,19 +1,17 @@
-/* eslint-env browser */
-/* eslint-disable n/no-unsupported-features/node-builtins */
-
 const level = (() => {
 	if (!('navigator' in globalThis)) {
 		return 0;
 	}
 
-	if (globalThis.navigator.userAgentData) {
+	if (navigator.userAgentData) {
 		const brand = navigator.userAgentData.brands.find(({brand}) => brand === 'Chromium');
 		if (brand?.version > 93) {
 			return 3;
 		}
 	}
 
-	if (/\b(Chrome|Chromium)\//.test(globalThis.navigator.userAgent)) {
+	// eslint-disable-next-line require-unicode-regexp -- This entry point supports browsers without Unicode Sets.
+	if (/\b(?:Chrome|Chromium)\//.test(navigator.userAgent)) {
 		return 1;
 	}
 

index.js

@@ -47,7 +47,11 @@ function envForceColor() {
 		return 1;
 	}
 
-	const level = Math.min(Number.parseInt(env.FORCE_COLOR, 10), 3);
+	if (!/^\d+$/v.test(env.FORCE_COLOR)) {
+		return;
+	}
+
+	const level = Math.min(Number(env.FORCE_COLOR), 3);
 
 	if (![0, 1, 2, 3].includes(level)) {
 		return;
@@ -69,6 +73,7 @@ function translateLevel(level) {
 	};
 }
 
+// eslint-disable-next-line complexity -- Color support detection necessarily handles multiple environments.
 function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	const noFlagForceColor = envForceColor();
 	if (noFlagForceColor !== undefined) {
@@ -94,7 +99,7 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	}
 
 	// A numeric `FORCE_COLOR` requests an exact level, while `FORCE_COLOR=true` and `FORCE_COLOR=` only enable color and let the level be detected.
-	if (forceColor !== undefined && /^\d+$/.test(env.FORCE_COLOR)) {
+	if (forceColor !== undefined && /^\d+$/v.test(env.FORCE_COLOR)) {
 		return forceColor;
 	}
 
@@ -129,19 +134,19 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	}
 
 	if ('CI' in env) {
-		if (['GITHUB_ACTIONS', 'GITEA_ACTIONS', 'CIRCLECI'].some(key => key in env)) {
+		if (['GITHUB_ACTIONS', 'GITEA_ACTIONS', 'CIRCLECI'].some(key => Object.hasOwn(env, key))) {
 			return 3;
 		}
 
-		if (['TRAVIS', 'APPVEYOR', 'GITLAB_CI', 'BUILDKITE', 'DRONE'].some(sign => sign in env) || env.CI_NAME === 'codeship') {
+		if (['TRAVIS', 'APPVEYOR', 'GITLAB_CI', 'BUILDKITE', 'DRONE'].some(sign => Object.hasOwn(env, sign)) || env.CI_NAME === 'codeship') {
 			return 1;
 		}
 
 		return min;
 	}
 
 	if ('TEAMCITY_VERSION' in env) {
-		return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.test(env.TEAMCITY_VERSION) ? 1 : 0;
+		return /^(?:9\.0*[1-9]\d*\.|\d{2,}\.)/v.test(env.TEAMCITY_VERSION) ? 1 : 0;
 	}
 
 	if (env.COLORTERM === 'truecolor') {
@@ -161,7 +166,7 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 	}
 
 	if ('TERM_PROGRAM' in env) {
-		const version = Number.parseInt((env.TERM_PROGRAM_VERSION || '').split('.')[0], 10);
+		const version = Number((env.TERM_PROGRAM_VERSION || '').split('.', 1)[0]);
 
 		switch (env.TERM_PROGRAM) {
 			case 'iTerm.app': {
@@ -175,11 +180,11 @@ function _supportsColor(haveStream, {streamIsTTY, sniffFlags = true} = {}) {
 		}
 	}
 
-	if (/-256(color)?$/i.test(env.TERM)) {
+	if (/-256(?:color)?$/iv.test(env.TERM)) {
 		return 2;
 	}
 
-	if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/i.test(env.TERM)) {
+	if (/^screen|^xterm|^vt100|^vt220|^rxvt|color|ansi|cygwin|linux/iv.test(env.TERM)) {
 		return 1;
 	}
 

package.json

@@ -18,7 +18,7 @@
 	},
 	"sideEffects": false,
 	"engines": {
-		"node": ">=18"
+		"node": ">=22"
 	},
 	"scripts": {
 		"test": "xo && ava && tsd"
@@ -52,10 +52,10 @@
 		"16m"
 	],
 	"devDependencies": {
-		"@types/node": "^22.10.2",
-		"ava": "^6.2.0",
-		"tsd": "^0.31.2",
-		"xo": "^0.60.0"
+		"@types/node": "^26.1.1",
+		"ava": "^8.0.1",
+		"tsd": "^0.33.0",
+		"xo": "^4.0.0"
 	},
 	"ava": {
 		"serial": true,

readme.md

@@ -58,9 +58,9 @@ The options object supports a single boolean property `sniffFlags`. By default i
 
 It obeys the `--color` and `--no-color` CLI flags.
 
-For situations where using `--color` is not possible, use the environment variable `FORCE_COLOR=1` (level 1), `FORCE_COLOR=2` (level 2), or `FORCE_COLOR=3` (level 3) to forcefully enable color, or `FORCE_COLOR=0` to forcefully disable. A numeric `FORCE_COLOR` overrides all other color support checks and is used as-is, meaning the terminal cannot raise it to a higher level. Use `FORCE_COLOR=true` to instead only enable color and let the level be detected.
+For situations where using `--color` is not possible, use the environment variable `FORCE_COLOR=1` (level 1), `FORCE_COLOR=2` (level 2), or `FORCE_COLOR=3` (level 3) to forcefully enable color, or `FORCE_COLOR=0` to forcefully disable. A numeric `FORCE_COLOR` overrides the detected color support and sets the level directly, meaning the terminal cannot raise it to a higher level. Use `FORCE_COLOR=true` to instead only enable color and let the level be detected.
 
-Explicit 256/Truecolor mode can be enabled using the `--color=256` and `--color=16m` flags, respectively.
+Explicit 256/Truecolor mode can be enabled using the `--color=256` and `--color=16m` flags, respectively. These take precedence over a non-zero numeric `FORCE_COLOR`.
 
 ## Related
 

test.js

@@ -400,6 +400,14 @@ test('a non-numeric FORCE_COLOR is ignored', async t => {
 	t.false(result.stdout);
 });
 
+test('a partially numeric FORCE_COLOR is ignored', async t => {
+	process.env.FORCE_COLOR = '1abc';
+	process.env.TERM = 'xterm-256color';
+	const result = await importMain();
+	t.truthy(result.stdout);
+	t.is(result.stdout.level, 2);
+});
+
 test('FORCE_COLOR works when set via command line (all values are strings)', async t => {
 	let result;
 	process.env.FORCE_COLOR = 'true';