{"id":13397827,"url":"https://github.com/ehmicky/nve","last_synced_at":"2025-05-14T13:06:13.459Z","repository":{"id":40571823,"uuid":"201104057","full_name":"ehmicky/nve","owner":"ehmicky","description":"Run any command on specific Node.js versions","archived":false,"fork":false,"pushed_at":"2025-03-29T03:50:42.000Z","size":14155,"stargazers_count":702,"open_issues_count":0,"forks_count":15,"subscribers_count":10,"default_branch":"main","last_synced_at":"2025-05-12T10:47:48.287Z","etag":null,"topics":["bash","cli","command-line","dependency-management","es6","exec","javascript","library","node","nodejs","npmjs","npx","nvm","operating-system","package-manager","server","shell","terminal","versioning","versions"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ehmicky.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2019-08-07T18:13:03.000Z","updated_at":"2025-05-07T16:50:57.000Z","dependencies_parsed_at":"2024-01-12T00:28:11.437Z","dependency_job_id":"c274e206-2f72-4c06-b6df-5d191869f4b6","html_url":"https://github.com/ehmicky/nve","commit_stats":{"total_commits":1440,"total_committers":3,"mean_commits":480.0,"dds":0.01666666666666672,"last_synced_commit":"c84351e1a3ff34f2ee5d12aa8c3e0deea595da53"},"previous_names":[],"tags_count":78,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnve","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnve/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnve/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnve/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ehmicky","download_url":"https://codeload.github.com/ehmicky/nve/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254149949,"owners_count":22022851,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bash","cli","command-line","dependency-management","es6","exec","javascript","library","node","nodejs","npmjs","npx","nvm","operating-system","package-manager","server","shell","terminal","versioning","versions"],"created_at":"2024-07-30T18:01:47.514Z","updated_at":"2025-05-14T13:06:13.369Z","avatar_url":"https://github.com/ehmicky.png","language":"JavaScript","readme":"\u003cpicture\u003e\n  \u003csource media=\"(prefers-color-scheme: dark)\" srcset=\"https://raw.githubusercontent.com/ehmicky/design/main/nve/nve_dark.svg\"/\u003e\n  \u003cimg alt=\"nve logo\" src=\"https://raw.githubusercontent.com/ehmicky/design/main/nve/nve.svg\" width=\"500\"/\u003e\n\u003c/picture\u003e\n\n[![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js\u0026colorA=404040\u0026logoColor=66cc33)](https://www.npmjs.com/package/nve)\n[![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov\u0026colorA=404040)](https://codecov.io/gh/ehmicky/nve)\n[![Mastodon](https://img.shields.io/badge/-Mastodon-808080.svg?logo=mastodon\u0026colorA=404040\u0026logoColor=9590F9)](https://fosstodon.org/@ehmicky)\n[![Medium](https://img.shields.io/badge/-Medium-808080.svg?logo=medium\u0026colorA=404040)](https://medium.com/@ehmicky)\n\nRun any command on specific Node.js versions.\n\nUnlike [`nvm exec`](https://github.com/nvm-sh/nvm/blob/master/README.md#usage)\nit:\n\n- can run [multiple Node.js versions](#examples-multiple-versions) at once\n- can be run [programmatically](https://github.com/ehmicky/nvexeca)\n- is [much faster](#benchmarks)\n- does not need a separate installation step for each Node version\n- can run the major release's latest minor/patch version automatically\n- works on Windows. No need to run as Administrator.\n- does not require Bash\n- is installed as a Node module (as opposed to a\n  [Bash installation script](https://github.com/nvm-sh/nvm/blob/master/README.md#installation-and-update)\n  downloaded with `curl`)\n\n`nve` executes a **single file or command**. It does not change the `node` nor\n`npm` global binaries. To run a specific Node.js version for an **entire project\nor shell session**, please use [`nvm`](https://github.com/nvm-sh/nvm),\n[`nvm-windows`](https://github.com/coreybutler/nvm-windows),\n[`n`](https://github.com/tj/n) or [`nvs`](https://github.com/jasongin/nvs)\ninstead.\n\n# Examples\n\n```bash\n# Same as `node` but with Node 12\n$ nve 12 node\nWelcome to Node.js v12.22.12.\nType \".help\" for more information.\n\u003e .exit\n\n# Same as `node file.js` but with Node 8\n$ nve 8 node file.js\n\n# Any command can be used\n$ nve 12 npm test\n\n# Execute a local binary\n$ nve 8 ava\n\n# Run a specific version\n$ nve 8.10.0 npm test\n\n# Use a version range\n$ nve \"\u003c8\" npm test\n\n# Run the latest Node.js version\n$ nve latest npm test\n\n# Run the latest LTS version\n$ nve lts npm test\n\n# Run the Node version from `~/.nvmrc` or the current process version\n$ nve global npm test\n\n# Run the current directory's Node.js version using its `.nvmrc` or `package.json` (`engines.node` field)\n$ nve local npm test\n\n# Run the Node version using a file like `.nvmrc` or `package.json`\n$ nve /path/to/.nvmrc npm test\n\n# Use a different mirror for the Node binaries\n$ nve --mirror=https://npmmirror.com/mirrors/node 8 npm test\n\n# Do not use the cached list of available Node.js versions\n$ nve --fetch 8 npm test\n\n# Always use the cached list of available Node.js versions even if it's more\n# than one hour old\n$ nve --no-fetch 8 npm test\n\n# Use a different CPU architecture for the Node binaries\n$ nve --arch=x32 8 npm test\n\n# Chaining commands\n$ nve 8 npm run build \u0026\u0026 nve 8 npm test\n\n# Cache Node 8 download\n$ nve 8 node --version\n```\n\n# Examples (multiple versions)\n\n```bash\n# Run multiple versions\n$ nve 12,10,8 npm test\n\n ⬢  Node 12.22.12\n\n  105 tests passed\n  Finished 'test' after 3.8 s\n\n ⬢  Node 10.24.1\n\n  105 tests passed\n  Finished 'test' after 4.2 s\n\n ⬢  Node 8.17.0\n\n  105 tests passed\n  Finished 'test' after 4.5 s\n\n# Do not abort on the first version that fails\n$ nve --continue 12,10,8 npm test\n\n# Run all versions in parallel\n$ nve --parallel 12,10,8 npm test\n\n# Cache multiple Node downloads\n$ nve 12,10,8 node --version\n```\n\n# Examples (list versions)\n\n```bash\n# Prints latest Node.js version\n$ nve latest\n20.4.0\n\n# Prints latest Node.js 8 version\n$ nve 8\n8.17.0\n\n# Prints latest Node.js 12, 10 and 8 versions\n$ nve 12,10,8\n12.22.12\n10.24.1\n8.17.0\n```\n\n# Install\n\n```bash\nnpm install -g nve\n```\n\n`node \u003e=18.18.0` must be globally installed. However the command run by `nve`\ncan use any Node version (providing it is compatible with it).\n\nTo use this programmatically (from Node.js) instead, please check\n[`nvexeca`](https://github.com/ehmicky/nvexeca).\n\n# Usage\n\n```bash\nnve [OPTIONS...] VERSION,... [COMMAND] [ARGS...]\n```\n\nThis is exactly the same as:\n\n```bash\nCOMMAND [ARGS...]\n```\n\nBut using a specific Node `VERSION`. Several comma-separated `VERSION` can be\nspecified at once.\n\n`VERSION` can be:\n\n- any [version range](https://github.com/npm/node-semver) such as `12`, `12.6.0`\n  or `\u003c12`\n- `latest`: Latest available Node version\n- `lts`: Latest LTS Node version\n- `global`: Global Node version\n  - Using the home directory [`.nvmrc`](https://github.com/nvm-sh/nvm#nvmrc) or\n    [`package.json` (`engines.node` field)](https://docs.npmjs.com/files/package.json#engines)\n  - [Some similar files](https://github.com/ehmicky/preferred-node-version/blob/main/README.md)\n    used by other Node.js version managers are also searched for\n  - If nothing is found, defaults to the current process's Node version\n- `local`: Current directory's Node version\n  - Using the current directory or parent directories\n    [`.nvmrc`](https://github.com/nvm-sh/nvm#nvmrc),\n    [`package.json` (`engines.node` field)](https://docs.npmjs.com/files/package.json#engines)\n    or\n    [similar files](https://github.com/ehmicky/preferred-node-version/blob/main/README.md)\n  - Defaults to the `global` version\n- a file path towards a [`.nvmrc`](https://github.com/nvm-sh/nvm#nvmrc),\n  [`package.json` (`engines.node` field)](https://docs.npmjs.com/files/package.json#engines)\n  or\n  [similar files](https://github.com/ehmicky/preferred-node-version/blob/main/README.md)\n\n`COMMAND` must be compatible with the specific Node `VERSION`. For example `npm`\nis [only compatible with Node `\u003e=6`](https://github.com/npm/cli#important).\n\nBoth global and local binaries can be executed.\n\n## Options\n\n### --continue\n\n_Alias_: `-c`\\\n_Type_: `boolean`\\\n_Default_: `false`\n\nBy default, when running multiple Node versions and one of those versions fails,\nthe others are aborted. This option disables this.\n\n### --parallel\n\n_Alias_: `-p`\\\n_Type_: `boolean`\\\n_Default_: `false`\n\nWhen running multiple Node versions, run all of them at the same time. This is\nfaster. However this does not work if the command:\n\n- requires some interactive CLI input (for example using a prompt)\n- is not concurrency-safe\n\n### --progress\n\n_Type_: `boolean`\\\n_Default_: `true`\n\nWhether to show a progress bar while the Node binary is downloading.\n\n### --mirror\n\n_Alias_: `-m`\\\n_Type_: `string`\\\n_Default_: `https://nodejs.org/dist`\n\nBase URL to retrieve Node binaries. Can be overridden (for example\n`https://npmmirror.com/mirrors/node`).\n\nThe following environment variables can also be used: `NODE_MIRROR`,\n`NVM_NODEJS_ORG_MIRROR`, `N_NODE_MIRROR` or `NODIST_NODE_MIRROR`.\n\n### --fetch\n\n_Alias_: `-f`\\\n_Type_: `boolean`\\\n_Default_: `undefined`\n\nThe list of available Node.js versions is cached for one hour by default. With:\n\n- `--fetch`: the cache will not be used\n- `--no-fetch`: the cache will be used even if it's older than one hour\n\nThe default value is `undefined` (neither of the above). When no `COMMAND` is\nspecified (only printing the Node.js version), the default value is `--fetch`\ninstead.\n\n### --arch\n\n_Alias_: `-a`\\\n_Type_: `string`\\\n_Default_: [`process.arch`](https://nodejs.org/api/process.html#process_process_arch)\n\nNode.js binary's CPU architecture. This is useful for example when you're on x64\nbut would like to run Node.js x32.\n\nAll the values from\n[`process.arch`](https://nodejs.org/api/process.html#process_process_arch) are\nallowed except `mips` and `mipsel`.\n\n## Initial download\n\nThe first time `nve` is run with a new `VERSION`, the Node binary is downloaded\nunder the hood. This initially takes few seconds. However subsequent runs are\n[almost instantaneous](#benchmarks).\n\n`COMMAND` can be omitted in order to cache that initial download without\nexecuting any commands.\n\n## Difference with nvm\n\n`nve` is meant for one-off command execution. Examples include:\n\n- running tests with an older Node.js version\n- checking if an older Node.js version supports a specific syntax or feature\n- benchmarking different Node.js versions\n- [programmatic usage or child processes](https://github.com/ehmicky/nvexeca)\n\nTools like [`nvm`](https://github.com/nvm-sh/nvm),\n[`nvm-windows`](https://github.com/coreybutler/nvm-windows),\n[`n`](https://github.com/tj/n) or [`nvs`](https://github.com/jasongin/nvs) are\nmeant to execute a specific Node.js version for an entire machine, project or\nshell session.\n\n`nve` can (and probably should) be used alongside those tools.\n\n## Native modules\n\nIf your code is using native modules, `nve` works providing:\n\n- they are built with [N-API](https://nodejs.org/api/n-api.html)\n- the target Node.js version is `\u003e=8.12.0` (since N-API was not available or\n  stable before that)\n\nOtherwise the following error message is shown:\n`Error: The module was compiled against a different Node.js version`.\n\n# Benchmarks\n\nThe [following benchmarks](benchmark/tasks.yml) compare the average time to run\n`nve`, [`nvm exec`](https://github.com/nvm-sh/nvm) and\n[`npx node`](https://github.com/aredridel/node-bin-gen/blob/master/node-bin-README.md#use-with-npx):\n\n```\nnve:       295ms\nnvm exec:  741ms\nnpx node: 1058ms\n```\n\n# See also\n\n- [`nvexeca`](https://github.com/ehmicky/nvexeca): Like `nve` but programmatic\n  (from Node.js)\n- [`execa`](https://github.com/sindresorhus/execa): Process execution for humans\n- [`get-node`](https://github.com/ehmicky/get-node): Download Node.js\n- [`preferred-node-version`](https://github.com/ehmicky/preferred-node-version):\n  Get the preferred Node.js version of a project or user\n- [`node-version-alias`](https://github.com/ehmicky/node-version-alias): Resolve\n  Node.js version aliases like `latest`, `lts` or `erbium`\n- [`normalize-node-version`](https://github.com/ehmicky/normalize-node-version):\n  Normalize and validate Node.js versions\n- [`all-node-versions`](https://github.com/ehmicky/all-node-versions): List all\n  available Node.js versions\n- [`fetch-node-website`](https://github.com/ehmicky/fetch-node-website): Fetch\n  releases on nodejs.org\n- [`global-cache-dir`](https://github.com/ehmicky/global-cache-dir): Get the\n  global cache directory\n\n# Support\n\nFor any question, _don't hesitate_ to [submit an issue on GitHub](../../issues).\n\nEveryone is welcome regardless of personal background. We enforce a\n[Code of conduct](CODE_OF_CONDUCT.md) in order to promote a positive and\ninclusive environment.\n\n# Contributing\n\nThis project was made with ❤️. The simplest way to give back is by starring and\nsharing it online.\n\nIf the documentation is unclear or has a typo, please click on the page's `Edit`\nbutton (pencil icon) and suggest a correction.\n\nIf you would like to help us fix a bug or add a new feature, please check our\n[guidelines](CONTRIBUTING.md). Pull requests are welcome!\n\nThanks go to our wonderful contributors:\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://fosstodon.org/@ehmicky\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/8136211?v=4?s=100\" width=\"100px;\" alt=\"ehmicky\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eehmicky\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/nve/commits?author=ehmicky\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#design-ehmicky\" title=\"Design\"\u003e🎨\u003c/a\u003e \u003ca href=\"#ideas-ehmicky\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e \u003ca href=\"https://github.com/ehmicky/nve/commits?author=ehmicky\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://scottwarren.dev\"\u003e\u003cimg src=\"https://avatars2.githubusercontent.com/u/2718494?v=4?s=100\" width=\"100px;\" alt=\"Scott Warren\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eScott Warren\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#question-scottwarren\" title=\"Answering Questions\"\u003e💬\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/tunnckocore\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/5038030?v=4?s=100\" width=\"100px;\" alt=\"Charlike Mike Reagent\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eCharlike Mike Reagent\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#question-tunnckoCore\" title=\"Answering Questions\"\u003e💬\u003c/a\u003e \u003ca href=\"#ideas-tunnckoCore\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/Hongarc\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/19208123?v=4?s=100\" width=\"100px;\" alt=\"Hongarc\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eHongarc\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"#ideas-Hongarc\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://github.com/papb\"\u003e\u003cimg src=\"https://avatars3.githubusercontent.com/u/20914054?v=4?s=100\" width=\"100px;\" alt=\"Pedro Augusto de Paula Barbosa\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003ePedro Augusto de Paula Barbosa\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/nve/issues?q=author%3Apapb\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://twitter.com/adrieankhisbe\"\u003e\u003cimg src=\"https://avatars1.githubusercontent.com/u/2601132?v=4?s=100\" width=\"100px;\" alt=\"Adrien Becchis\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eAdrien Becchis\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/nve/commits?author=AdrieanKhisbe\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/ehmicky/nve/commits?author=AdrieanKhisbe\" title=\"Tests\"\u003e⚠️\u003c/a\u003e \u003ca href=\"#ideas-AdrieanKhisbe\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\" valign=\"top\" width=\"14.28%\"\u003e\u003ca href=\"https://www.ericcornelissen.dev/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/3742559?v=4?s=100\" width=\"100px;\" alt=\"Eric Cornelissen\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eEric Cornelissen\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/nve/issues?q=author%3Aericcornelissen\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e \u003ca href=\"#ideas-ericcornelissen\" title=\"Ideas, Planning, \u0026 Feedback\"\u003e🤔\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n","funding_links":[],"categories":["JavaScript","Packages","包","目录","bash","terminal","cli","Version Managers","For Developers"],"sub_categories":["Testing","测试","测试相关","Node.js","Directory Navigation"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fnve","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fehmicky%2Fnve","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fnve/lists"}