Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

all-node-versions

ehmicky354.3kApache-2.013.0.1TypeScript support: included

List all available Node.js versions

nodejs, node, nvm, npx, versions, versioning, exec, shell, terminal, command-line, cli, dependency-management, es6, javascript, typescript, library, npmjs, operating-system, package-manager, bash

readme

Node TypeScript Codecov Mastodon Medium

List all available Node.js versions.

Sorted from the most to the least recent. Includes major release and LTS information.

Install

npm install all-node-versions

This package works in Node.js >=18.18.0.

This is an ES module. It must be loaded using an import or import() statement, not require(). If TypeScript is used, it must be configured to output ES modules, not CommonJS.

Usage

import allNodeVersions from 'all-node-versions'

const {
  versions,
  // [
  //   { node: '18.4.0', npm: '8.12.1' },
  //   { node: '18.3.0', npm: '8.11.0' },
  //   ...
  //   { node: '0.1.14' },
  // ]
  majors,
  // [
  //   { major: 18, latest: '18.4.0' },
  //   { major: 17, latest: '17.9.1' },
  //   { major: 16, latest: '16.15.1', lts: 'gallium' },
  //   { major: 15, latest: '15.14.0' },
  //   { major: 14, latest: '14.19.3', lts: 'fermium },
  //   { major: 13, latest: '13.14.0' },
  //   { major: 12, latest: '12.22.12', lts: 'erbium' },
  //   { major: 11, latest: '11.15.0' },
  //   { major: 10, latest: '10.24.1', lts: 'dubnium' },
  //   { major: 9, latest: '9.11.2' },
  //   { major: 8, latest: '8.17.0', lts: 'carbon' },
  //   { major: 7, latest: '7.10.1' },
  //   { major: 6, latest: '6.17.1', lts: 'boron' },
  //   { major: 5, latest: '5.12.0' },
  //   { major: 4, latest: '4.9.1', lts: 'argon' },
  //   { major: 0, latest: '0.12.18' }
  // ]
} = await allNodeVersions(options)

allNodeVersions(options?)

options: object\ Returns: Promise<object>

Return value

The return value resolves to an object with the following properties.

versions

Type: object[]

List of available Node.js versions and related information. Sorted from the most to the least recent Node.js version.

node

Type: string

Node.js version as a major.minor.patch string.

npm

Type: string?

Default NPM version as a major.minor.patch[-tags] string. undefined if the node version is 0.6.2 or older.

majors

Type: object[]

List of Node.js major releases sorted from the most to the least recent. Each major release has the following properties.

major

Type: number

Major version number. 0 for old releases 0.*.*.

latest

Type: string

Latest version for that major release, as a major.minor.patch string.

lts

Type: string?

LTS name, lowercased. undefined if the major release is not LTS.

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

Cancels when the signal is aborted.

See also

Support

For any question, don't hesitate to submit an issue on GitHub.

Everyone is welcome regardless of personal background. We enforce a Code of conduct 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. Pull requests are welcome!


ehmicky

💻 🎨 🤔 📖

Maxim Mazurok

🤔 💻 ⚠️ 📖

changelog

13.0.1

Documentation

  • Improve documentation in README.md

13.0.0

Breaking changes

  • Minimal supported Node.js version is now 18.18.0

12.1.0

Features

12.0.0

Breaking changes

  • Minimal supported Node.js version is now 16.17.0

11.3.0

Features

  • Improve tree-shaking support

11.2.0

Features

  • Reduce npm package size by 70%

11.1.0

Features

  • Reduce npm package size

11.0.1

Bug fixes

  • Fix some issues with file caching

11.0.0

Breaking changes

Features

  • The default NPM versions of each Node.js release are now returned

10.1.1

Bug fixes

  • Prevent mutating cached return value

10.1.0

Features

  • Add TypeScript types

10.0.0

Breaking changes

  • Minimal supported Node.js version is now 14.18.0

9.0.0

Breaking changes

  • Minimal supported Node.js version is now 12.20.0
  • This package is now an ES module. It can only be loaded with an import or import() statement, not require(). See this post for more information.

Bug fixes

  • Fix offline mode

8.0.0

Breaking changes

Features

  • Add information about major releases including latest version and LTS name

7.0.1

Dependencies

  • Fix removing core-js

7.0.0

Features

  • Cache the list of available Node.js versions for one hour
  • Add fetch option to configure this caching
  • Works offline, providing it has been previously cached

Dependencies

  • Remove core-js

6.0.1

Bug fixes

  • Fix terminal color changing on Windows

6.0.0

Breaking changes

  • Minimal supported Node.js version is now 10.17.0

5.0.2

Bug fixes

  • Fix crash when Node.js binary URL is invalid

5.0.1

Dependencies

  • Upgrade fetch-node-website to 4.1.0

5.0.0

Breaking changes

  • Remove CLI.

4.1.0

Dependencies

  • Upgrade fetch-node-website to 4.0.0

4.0.4

Bug fixes

  • Fix progress bar jitter.

4.0.3

Internal

  • Improve the appearance of the progress bar (which is not used at the moment)

4.0.2

Bug fixes

  • Fix a bug on non-interactive terminals

4.0.1

Internal

  • Internal changes

4.0.0

Breaking changes

  • Remove the progress option and CLI flag.

3.0.0

Breaking changes

  • Change the progress option default value from true to false. That option displays a loading spinner.

Features

2.3.3

Internal

  • Internal changes

2.3.2

Bugs

  • Fix CTRL-C not working

2.3.1

Dependencies

  • Upgrade fetch-node-website

2.3.0

Features

2.2.0

Features

  • Improve progress messages on console
  • Add alternative names for NODE_MIRROR: NVM_NODEJS_ORG_MIRROR, N_NODE_MIRROR and NODIST_NODE_MIRROR

2.1.0

Features

  • Add CLI

2.0.0

Features

  • Retry downloading the Node.js index file on network errors.

1.0.1

Internal

  • Internal changes