get-node-versions

get-node-versions is a simple package to get an array of specific node versions.

Installation

As a library

npm install --save get-node-versions

As a cli tool

npm install -g get-node-versions

Usage

As a library

import {GetNodeVersions} from "get-node-versions"

GetNodeVersions.parse(["major", "minor | eq:6", "0.12"]).then((versions) => {
    console.log(versions);
});

As a cli program

$ get-node-versions "major | eq:6" "minor | lt:5 | gte:4.0.0"
4.1.2
4.2.6
4.3.2
4.4.7
4.5.0
4.6.0
6.7.0

API

GetNodeVersions

• parse(versions: string | Array<string>): Promise<Array<string>>
  • Parse input and return valid nodejs versions
• NODEJS_MIRROR: string
  • Mirror to use to retrieve the nodejs version list. default: https://nodejs.org/dist/
• versionListCache: Array<VersionListCacheItem>
  • Set this to skip pulling versions from the mirror.

VersionListCacheItem

• version: string
• date: string
• files: Array<string>
• npm: string
• v8: string
• uv: string
• zlib: string
• openssl: string
• modules: string
• lts: boolean

Versions Syntax

get-node-versions sports a very flexible version syntax. The version syntax follows the following format:

(version or keyword) | filter | filter | ...

You must specify one version or one keyword and then any number of filters (or zero). Whitespace is optional.

Possible Versions

| Version | Example | Description | |:--------|:--------|:------------------------------------------------| | X | 6 | Resolves to the greatest single version of X. | | X.Y | 6.1 | Resolves to the greatest single version of X.Y. | | X.Y.Z | 6.1.2 | Resolves to exactly X.Y.Z. |

Possible Keywords

| Keyword | Description | |:-------:|:-----------------------------------------------------------------------------------------------------| | major | Resolves to a list of all the latest major versions. Does not include legacy versions. | | minor | Resolves to a list of all the latest minor versions. Does not include legacy versions. | | patch | Resolves to a list of all patch versions. Does not include legacy versions. | | legacy | Resolves to a list of all the legacy versions, which is everything that starts with major version 0. | | all | Resolves to every single version available. |

Possible Filters

| Filter | Description | |:-----------:|:------------------------------------------------------------| | gt:version | Filter to only versions greater than version. | | gte:version | Filter to only versions greater than or equal to version. | | lt:version | Filter to only versions less than version. | | lte:version | Filter to only versions less than or equal to version. | | eq:version | Filter to only versions matching version. | | neq:version | Filter to only versions not matching version. | | lts | Filter to only LTS versions. |

version can be a partial version.

Examples

Minor versions of v6, and major versions of everything else.

get-node-versions -"minor | eq:6" "major | lt:6"

All major versions, plus a subset of version 4.

get-node-versions "major" "patch | gte:4.2 | lte:4.6"

Every single LTS version and the popular legacy versions.

get-node-versions "patch | lts" 0.12 0.10

You do not need to worry if multiple versions overlap, as they are de-duplicated.