Componentpedia / Listings / node-version

Last update: 27/12/2025

node-version

Get Node current version

Latest version: 4.0.0 registry icon
Maintenance score
100
Safety score
100
Popularity score
27
Check your open source dependency risks. Get immediate insight about security, stability and licensing risks.
De-risk your app now
Security
  Vulnerabilities
Version Suggest Low Medium High Critical
4.0.0 0 0 0 0 0
3.0.0 0 0 0 0 0
2.0.0 0 0 0 0 0
1.2.0 0 0 0 0 0
1.1.3 0 0 0 0 0
1.1.2 0 0 0 0 0
1.1.0 0 0 0 0 0
1.0.0 0 0 0 0 0
0.1.0 0 0 0 0 0

Stability
Latest release:

4.0.0 - This version is safe to use because it has no known security vulnerabilities at this time. Find out if your coding project uses this component and get notified of any reported security vulnerabilities with Meterian-X Open Source Security Platform

Licensing

Maintain your licence declarations and avoid unwanted licences to protect your IP the way you intended.

MIT   -   MIT License

Not a wildcard

Not proprietary

OSI Compliant

NPM Version NPM Downloads GitHub Actions Codecov

node-version

A lightweight utility to get the current Node.js version parsed into a structured object.

Features

  • 🚀 Fast and Lightweight: Barely any overhead.
  • 📦 ESM Only: Built for modern environments.
  • 🛠️ TypeScript Ready: Full type definitions included.
  • 📅 LTS & EOL Checks: Identify LTS releases and End-of-Life versions.
  • 🚦 Comparison Helpers: is(), isAtLeast(), isAbove(), isBelow(), isAtMost() checks.

Installation

# Using npm
npm install node-version

# Using Yarn
yarn add node-version

# Using pnpm
pnpm add node-version

# Using Bun
bun add node-version

Quick Start

import { version } from 'node-version';

console.log(version);
/*
{
    original: 'v20.10.0', // same as process.version
    short: '20.10',
    long: '20.10.0',
    major: '20',
    minor: '10',
    build: '0',

    isAtLeast: [Function],
    isAbove: [Function],
    isBelow: [Function],
    isAtMost: [Function],
    is: [Function],
    isLTS: true, // or false
    ltsName: 'Iron', // or undefined
    isEOL: false // or true
}
*/

API Reference

version

The pre-instantiated version object for the current process.

getVersion()

Returns a new NodeVersion object representing the current process version.

import { getVersion } from 'node-version';
const v = getVersion();

NodeVersion Object

Property Type Description
original string The version string prefixed with 'v' (e.g., 'v20.10.0').
short string The major and minor version (e.g., '20.10').
long string The full version string (e.g., '20.10.0').
major string The major version number.
minor string The minor version number.
build string The build/patch version number.
isAtLeast(version) (v: string) => boolean Checks if the current version is ≥ the specified version.
isAbove(version) (v: string) => boolean Checks if the current version is > the specified version.
isBelow(version) (v: string) => boolean Checks if the current version is < the specified version.
isAtMost(version) (v: string) => boolean Checks if the current version is ≤ the specified version.
is(version) (v: string) => boolean Checks if the current version is exactly the specified version.
isLTS boolean true if the current version is an LTS release.
ltsName string The LTS codename (e.g., 'Iron') or undefined.
isEOL boolean true if the current version is past its End-of-Life date.

Compare Versions

import { version } from 'node-version';

if (version.isAtLeast('20.0.0')) {
  console.log('Running on Node.js 20 or newer');
}

if (version.is('22.0.0')) {
  console.log('Running on exactly Node.js 22.0.0');
}

if (version.isAbove('20.0.0')) {
  console.log('Running on Node.js strictly above 20.0.0');
}

if (version.isBelow('22.0.0')) {
  console.log('Running on Node.js strictly below 22.0.0');
}

ESM Requirements

This package is ESM-only and requires Node.js 20+.

If you need CommonJS support, use node-version@3:

npm install node-version@3

Development

Scripts

  • bun run build: Build the project using tsdown.
  • bun run test: Run tests using vitest.
  • bun run lint: Run linting checks using biome.
  • bun run format: Format the code using biome.
  • bun run check-exports: Verify package exports are correct.

Publishing

This project uses Changesets for versioning and publishing.

# Prepare a new version (updates changelog and package.json)
bun run changeset:version

# Publish to NPM
bun run changeset:release

License

MIT