at-least-node

What is at-least-node?

The 'at-least-node' package is designed to ensure that a Node.js application or script is running on a minimum specified version of Node.js. It is particularly useful for developers who want to enforce a version requirement for their applications, preventing the application from running if the Node.js environment does not meet the specified minimum version. This can help avoid unexpected behavior or errors caused by using features that are not supported in older versions of Node.js.

What are at-least-node's main functionalities?

Version Checking

This feature allows developers to specify a minimum Node.js version requirement. The code example checks if the current Node.js version is at least version 10.0.0. If the version is older, the script will throw an error and prevent the application from running.

require('at-least-node')('10.0.0');

Other packages similar to at-least-node

semver

The 'semver' package is a module for semantic versioning comparison. While it does not directly enforce Node.js version requirements, it can be used to perform complex version checks and comparisons, including checking if the current Node.js version satisfies a given version range. This provides more flexibility compared to 'at-least-node' but requires additional code to enforce version requirements.

please-upgrade-node

Similar to 'at-least-node', 'please-upgrade-node' is a package designed to enforce a minimum Node.js version requirement for applications. It goes a step further by providing a friendly error message advising users to upgrade their Node.js version if the requirement is not met. This makes it a more user-friendly option compared to 'at-least-node', which simply throws an error without additional guidance.

engine-check

The 'engine-check' package automatically checks if the current Node.js version satisfies the version specified in the 'engines' field of 'package.json'. It is similar to 'at-least-node' in enforcing version requirements but does so based on the project's package.json configuration, offering a more integrated approach to version enforcement.

README

at-least-node

Sometimes you need to check if you're on at least a given Node.js version, but you don't want to pull in the whole semver kitchen sink. That's what at-least-node is for.

Package	Size
at-least-node	2.6 kB
semver	75.5 kB

const atLeastNode = require('at-least-node')
atLeastNode('10.12.0')
// -> true on Node 10.12.0+, false on anything below that

When passing in a version string:

• You cannot include a leading v (i.e. v10.12.0)
• You cannot omit sections (i.e. 10.12)
• You cannot use pre-releases (i.e. 1.0.0-beta)
• There is no input validation, if you make a mistake, the resulting behavior is undefined