README

@bevry/nodejs-versions

Filter the absolute or significant Node.js versions by vast amounts of criteria, such as LTS status.

Usage

import {
    preloadNodeVersions,
    filterSignificantNodeVersions,
    filterAbsoluteNodeVersions,
    filterNodeVersions,
} from '@bevry/nodejs-versions'

// Required for filters that use the Node.js Schedule or Releases API,
// or for prefetching of absolute and significant Node.js versions.
await preloadNodeVersions()

console.log(filterSignificantNodeVersions({ maintained: true }))
// e.g. [ '12', '14', '16' ]

console.log(filterSignificantNodeVersions({ current: true }))
// e.g. [ '16' ]

console.log(filterSignificantNodeVersions({ active: true }))
// e.g. [ '14' ]

console.log(filterSignificantNodeVersions({ maintenance: true }))
// e.g. [ '12' ]

console.log(filterAbsoluteNodeVersions({ current: true }))
// e.g. [ '16.0.0', '16.1.0', '16.2.0', '16.3.0', '16.4.0', '16.4.1', '16.4.2', '16.5.0' ]

console.log(filterNodeVersions(['12', '14', '16'], { current: true }))
// e.g. [ '16' ]

// The above example results were current as of 2021-07-27

// More filters are available via the [Complete API Documentation] link earlier.

Install

npm

Install: npm install --save @bevry/nodejs-versions
Import: import * as pkg from ('@bevry/nodejs-versions')
Require: const pkg = require('@bevry/nodejs-versions')

Editions

This package is published with the following editions:

@bevry/nodejs-versions/source/index.ts is TypeScript source code with Import for modules
@bevry/nodejs-versions aliases @bevry/nodejs-versions/edition-es2019/index.js
@bevry/nodejs-versions/edition-es2019/index.js is TypeScript compiled against ES2019 for Node.js 10 || 12 || 14 || 16 with Require for modules
@bevry/nodejs-versions/edition-es2019-esm/index.js is TypeScript compiled against ES2019 for Node.js 12 || 14 || 16 with Import for modules