# normalize-node-version > Normalize and validate Node.js versions Latest version **14.0.1** (published 2025-03-29) · Apache-2.0 license · 0 weekly downloads ## Install ```sh npm install normalize-node-version pnpm add normalize-node-version yarn add normalize-node-version bun add normalize-node-version ``` ## Health **Score 55/100 (C)** — status: stable. Positive: has types; esm support; no vulnerabilities; high maintenance score; high quality score. Warnings: low downloads. Negative: stale. ## Facts | | | |---|---| | Version | 14.0.1 | | Published | 2025-03-29 | | First published | 2019-08-08 | | Weekly downloads | 0 | | License | Apache-2.0 | | TypeScript types | bundled | | Module format | ESM + CommonJS | | Node | >=18.18.0 | | Dependencies | 3 | | Unpacked size | 20.9 KB | | Known vulnerabilities | 0 | | Install scripts | no | | GitHub stars | 8 | | Author | ehmicky | | Maintainers | ehmicky | | Keywords | nodejs, node, nvm, npx, versions, versioning, exec, shell, terminal, command-line, cli, dependency-management, es6, javascript, typescript, library, npmjs, operating-system, package-manager, bash | ## Links - npm: https://www.npmjs.com/package/normalize-node-version - Repository: https://github.com/ehmicky/normalize-node-version - Homepage: https://www.github.com/ehmicky/normalize-node-version - Issues: https://github.com/ehmicky/normalize-node-version/issues - npm.io page: https://npm.io/package/normalize-node-version ## Dependencies (3) - [semver](https://npm.io/package/semver.md) ^7.7.1 - [filter-obj](https://npm.io/package/filter-obj.md) ^6.1.0 - [all-node-versions](https://npm.io/package/all-node-versions.md) ^13.0.1 ## Alternatives - [@salesforce/cli](https://npm.io/package/@salesforce/cli.md) — 389.7K weekly downloads - [@mintlify/cli](https://npm.io/package/@mintlify/cli.md) — 208.9K weekly downloads - [@grafana/e2e-selectors](https://npm.io/package/@grafana/e2e-selectors.md) — 128.7K weekly downloads - [mintlify](https://npm.io/package/mintlify.md) — 112.0K weekly downloads - [@intlayer/cli](https://npm.io/package/@intlayer/cli.md) — 22.8K weekly downloads ## Recent versions - 14.0.1 (latest) — 2025-03-29 - 14.0.0 — 2023-10-28 - 13.1.0 — 2023-07-13 - 13.0.0 — 2023-05-13 - 12.4.0 — 2022-11-11 - 12.3.0 — 2022-10-18 - 12.2.0 — 2022-08-16 - 12.1.1 — 2022-06-26 - 12.1.0 — 2022-06-24 - 12.0.0 — 2022-05-09 - 11.0.0 — 2021-06-22 - 10.0.0 — 2020-04-21 - 9.0.1 — 2020-04-18 - 9.0.0 — 2020-04-17 - 8.0.1 — 2020-04-16 - … 33 more at https://npm.io/package/normalize-node-version/versions ## README [![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js&colorA=404040&logoColor=66cc33)](https://www.npmjs.com/package/normalize-node-version) [![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript&colorA=404040&logoColor=0096ff)](/src/main.d.ts) [![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov&colorA=404040)](https://codecov.io/gh/ehmicky/normalize-node-version) [![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon&colorA=404040&logoColor=9590F9)](https://fosstodon.org/@ehmicky) [![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium&colorA=404040)](https://medium.com/@ehmicky) Normalize and validate Node.js versions. Takes any version range as inputs such as `8`, `8.5.0` or `>=8` and returns a `"major.minor.patch"` string. Throws if the Node.js version does not exist. # Example ```js import normalizeNodeVersion from 'normalize-node-version' await normalizeNodeVersion('8') // '8.17.0' await normalizeNodeVersion('8.5.0') // '8.5.0' await normalizeNodeVersion('v8.5.0') // '8.5.0' await normalizeNodeVersion('<7') // '6.17.1' await normalizeNodeVersion('8.5.2') // Error: Invalid Node version await normalizeNodeVersion('not_a_version') // Error: Invalid Node version // All available options await normalizeNodeVersion('8', { // Use a mirror for Node.js binaries mirror: 'https://npmmirror.com/mirrors/node', // Do not cache the list of available Node.js versions fetch: true, // Cancels when the signal is aborted signal: new AbortController().signal, }) ``` # Install ```bash npm install normalize-node-version ``` This package works in Node.js >=18.18.0. This is an ES module. It must be loaded using [an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c), not `require()`. If TypeScript is used, it must be configured to [output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html), not CommonJS. # Usage ## normalizeNodeVersion(versionRange, options?) `versionRange`: `string`\ `options`: `object?`\ _Returns_: `Promise` ### options #### mirror _Type_: `string`\ _Default_: `https://nodejs.org/dist` Base URL to fetch the list of available Node.js versions. Can be customized (for example `https://npmmirror.com/mirrors/node`). The following environment variables can also be used: `NODE_MIRROR`, `NVM_NODEJS_ORG_MIRROR`, `N_NODE_MIRROR` or `NODIST_NODE_MIRROR`. #### fetch _Type_: `boolean`\ _Default_: `undefined` The list of available Node.js versions is cached for one hour by default. If the `fetch` option is: - `true`: the cache will not be used - `false`: the cache will be used even if it's older than one hour #### signal _Type_: [`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal) Cancels when the signal is aborted. # See also - [`nve`](https://github.com/ehmicky/nve): Run a specific Node.js version (CLI) - [`nvexeca`](https://github.com/ehmicky/nve): Run a specific Node.js version (programmatic) - [`get-node`](https://github.com/ehmicky/get-node): Download Node.js - [`preferred-node-version`](https://github.com/ehmicky/preferred-node-version): Get the preferred Node.js version of a project or user - [`node-version-alias`](https://github.com/ehmicky/node-version-alias): Resolve Node.js version aliases like `latest`, `lts` or `erbium` - [`all-node-versions`](https://github.com/ehmicky/all-node-versions): List all available Node.js versions - [`fetch-node-website`](https://github.com/ehmicky/fetch-node-website): Fetch releases on nodejs.org # Support For any question, _don't hesitate_ to [submit an issue on GitHub](../../issues). Everyone is welcome regardless of personal background. We enforce a [Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and inclusive environment. # Contributing This project was made with ❤️. The simplest way to give back is by starring and sharing it online. If the documentation is unclear or has a typo, please click on the page's `Edit` button (pencil icon) and suggest a correction. If you would like to help us fix a bug or add a new feature, please check our [guidelines](CONTRIBUTING.md). Pull requests are welcome! Thanks go to our wonderful contributors:

ehmicky
💻 🎨 🤔 📖
Adrien Becchis
💻 ⚠️ 🤔
Maxim Mazurok
🤔
--- _Source: https://npm.io/package/normalize-node-version · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._