Yarn Berry plugin to enforce Node version.
$ yarn plugin import https://raw.githubusercontent.com/devoto13/yarn-plugin-engines/main/bundles/%40yarnpkg/plugin-engines.js
Specify the desired Node version constraint using engines.node
field and the plugin will fail installation if the current Node version does not satisfy it:
$ cat package.json
{
"name": "my-package",
"engines": {
"node": ">= 42"
}
}
$ yarn
yarn
➤ YN0000: ┌ Project validation
➤ YN0000: │ The current node version 14.17.3 does not satisfy the required version >= 42.
➤ YN0000: └ Completed
➤ YN0000: Failed with errors in 0s 5ms
As well as fail a script execution with a non-zero exit code:
$ cat package.json
{
"name": "my-package",
"scripts": {
"build": "echo success!"
},
"engines": {
"node": ">= 42"
}
}
$ yarn build
The current node version 14.17.3 does not satisfy the required version >= 42.
node
to control the version of Node. Besides the desired version, it is possible to set this key to.nvmrc
or.node-version
constant. In this case plugin will read the desired version from the.nvmrc
file or.node-version
file.yarn
to control the version of Yarn.
Sometimes it is desired to ignore the engines check in certain environment. For example, when running renovate
which uses its own Node version not controlled by the project developer. In such cases PLUGIN_YARN_ENGINES_DISABLE=1
environment variable can be set to disable the plugin.
It's important to ensure that all developers on the team use the same version of Node to avoid "it does not work on my machine" kind of problems. With Yarn 1 one can set engines.node
field in the project's package.json
to communicate the required Node version, but this feature is missing in Yarn 2+. Hopefully one day this will be implemented in Yarn core making the plugin obsolete.