{"id":15007651,"url":"https://github.com/ehmicky/node-version-alias","last_synced_at":"2025-04-09T15:04:07.280Z","repository":{"id":40569304,"uuid":"256786223","full_name":"ehmicky/node-version-alias","owner":"ehmicky","description":"Resolve Node.js version aliases like `latest`, `lts` or `erbium`","archived":false,"fork":false,"pushed_at":"2025-03-29T03:44:28.000Z","size":8095,"stargazers_count":16,"open_issues_count":0,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-04-09T15:01:20.572Z","etag":null,"topics":["bash","cli","command-line","dependency-management","es6","exec","javascript","library","node","nodejs","npmjs","npx","nvm","operating-system","package-manager","shell","terminal","typescript","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}},"created_at":"2020-04-18T15:22:59.000Z","updated_at":"2025-04-09T10:15:50.000Z","dependencies_parsed_at":"2024-04-22T20:27:44.464Z","dependency_job_id":"34ee24cb-47fa-4042-a04a-a9ba5055fa91","html_url":"https://github.com/ehmicky/node-version-alias","commit_stats":{"total_commits":482,"total_committers":3,"mean_commits":"160.66666666666666","dds":"0.022821576763485507","last_synced_commit":"f2f6955d708a666c94452ad2a8876c5a397dc2d9"},"previous_names":[],"tags_count":13,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnode-version-alias","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnode-version-alias/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnode-version-alias/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ehmicky%2Fnode-version-alias/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ehmicky","download_url":"https://codeload.github.com/ehmicky/node-version-alias/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248055278,"owners_count":21040156,"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","shell","terminal","typescript","versioning","versions"],"created_at":"2024-09-24T19:13:08.600Z","updated_at":"2025-04-09T15:04:07.238Z","avatar_url":"https://github.com/ehmicky.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![Node](https://img.shields.io/badge/-Node.js-808080?logo=node.js\u0026colorA=404040\u0026logoColor=66cc33)](https://www.npmjs.com/package/node-version-alias)\n[![TypeScript](https://img.shields.io/badge/-Typed-808080?logo=typescript\u0026colorA=404040\u0026logoColor=0096ff)](/src/main.d.ts)\n[![Codecov](https://img.shields.io/badge/-Tested%20100%25-808080?logo=codecov\u0026colorA=404040)](https://codecov.io/gh/ehmicky/node-version-alias)\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\nResolve Node.js version aliases like `latest`, `lts` or `erbium`.\n\nThose aliases are used by Node.js version managers like\n[`nvm`](https://github.com/nvm-sh/nvm),\n[`nvs`](https://github.com/jasongin/nvs), [`n`](https://github.com/tj/n),\n[`nave`](https://github.com/isaacs/nave),\n[`nodeenv`](https://github.com/ekalinin/nodeenv) or\n[`nodist`](https://github.com/nullivex/nodist).\n\nThis resolves them to a `\"major.minor.patch\"` version string. The following\naliases are supported:\n\n- [`latest`](https://github.com/tj/n#specifying-node-versions),\n  [`stable`](https://github.com/nvm-sh/nvm#usage),\n  [`node`](https://github.com/nvm-sh/nvm#usage),\n  [`current`](https://github.com/tj/n#specifying-node-versions): latest version\n- [`lts`](https://github.com/jasongin/nvs#basic-usage) or\n  [`lts/*`](https://github.com/nvm-sh/nvm#long-term-support): latest LTS version\n- [`lts/-1`](https://github.com/nvm-sh/nvm#long-term-support),\n  [`lts/-2`](https://github.com/nvm-sh/nvm#long-term-support), etc.:\n  first/second/etc. latest LTS version\n- [`lts/erbium`](https://github.com/nvm-sh/nvm#long-term-support),\n  [`erbium`](https://github.com/nvm-sh/nvm#long-term-support), etc.: specific\n  LTS, using its [name](https://github.com/nodejs/Release) (case-insensitive)\n- nvm custom aliases (including `default`)\n- [`system`](https://github.com/nvm-sh/nvm#system-version-of-node): Node.js\n  version when `nvm` is deactivated\n- [`iojs`](https://github.com/nvm-sh/nvm#usage): always `4.0.0`\n- [`unstable`](https://github.com/nvm-sh/nvm#usage): always `0.11.6`\n\nNormal version ranges (like `12.1.0`, `12` or `\u003e=10`) are valid inputs too.\n\n# Examples\n\n```js\nimport nodeVersionAlias from 'node-version-alias'\n\n// Note: the following examples might be out-of-sync with the actual versions\nconsole.log(await nodeVersionAlias('latest')) // 19.3.0\nconsole.log(await nodeVersionAlias('lts')) // 18.12.1\nconsole.log(await nodeVersionAlias('lts/erbium')) // 12.22.12\nconsole.log(await nodeVersionAlias('erbium')) // 12.22.12\nconsole.log(await nodeVersionAlias('lts/-2')) // 14.21.2\n\n// Normal version ranges\nconsole.log(await nodeVersionAlias('10.0.0')) // 10.0.0\nconsole.log(await nodeVersionAlias('10')) // 10.24.1\nconsole.log(await nodeVersionAlias('^10')) // 10.24.1\nconsole.log(await nodeVersionAlias('\u003e=10')) // 19.3.0\n\n// Allowed options\nawait nodeVersionAlias('latest', {\n  // Use a mirror for Node.js binaries\n  mirror: 'https://npmmirror.com/mirrors/node',\n  // Do not cache the list of available Node.js versions\n  fetch: true,\n  // Cancels when the signal is aborted\n  signal: new AbortController().signal,\n})\n```\n\n# Install\n\n```bash\nnpm install node-version-alias\n```\n\nThis package works in Node.js \u003e=18.18.0.\n\nThis is an ES module. It must be loaded using\n[an `import` or `import()` statement](https://gist.github.com/sindresorhus/a39789f98801d908bbc7ff3ecc99d99c),\nnot `require()`. If TypeScript is used, it must be configured to\n[output ES modules](https://www.typescriptlang.org/docs/handbook/esm-node.html),\nnot CommonJS.\n\n# Usage\n\n## nodeVersionAlias(alias, options?)\n\n`alias`: `string`\\\n`options`: [`Options?`](#options)\\\n_Returns_: `Promise\u003cstring\u003e`\n\nThe return value resolves to a `\"major.minor.patch\"` version string.\n\n### Options\n\n#### mirror\n\n_Type_: `string`\\\n_Default_: `https://nodejs.org/dist`\n\nBase URL to fetch the list of available Node.js versions. Can be customized (for\nexample `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_Type_: `boolean`\\\n_Default_: `undefined`\n\nThe list of available Node.js versions is cached for one hour by default. If the\n`fetch` option is:\n\n- `true`: the cache will not be used\n- `false`: the cache will be used even if it's older than one hour\n\n#### signal\n\n_Type_:\n[`AbortSignal`](https://developer.mozilla.org/en-US/docs/Web/API/AbortSignal)\n\nCancels when the signal is aborted.\n\n# CLI\n\n[`nve`](https://github.com/ehmicky/nve) can be used to\n[run `node-version-alias` as a CLI](https://github.com/ehmicky/nve#examples-list-versions).\nThe [`--mirror`](https://github.com/ehmicky/nve#--mirror) and\n[`--fetch`](https://github.com/ehmicky/nve#--fetch) CLI flags are available.\n\n```bash\n# Prints latest Node.js version\n$ nve latest\n19.3.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.1\n10.24.1\n8.17.0\n```\n\n# See also\n\n- [`nvexeca`](https://github.com/ehmicky/nve): Run a specific Node.js version\n  (programmatic)\n- [`get-node`](https://github.com/ehmicky/get-node): Download Node.js\n- [`normalize-node-version`](https://github.com/ehmicky/normalize-node-version):\n  Normalize and validate Node.js versions\n- [`preferred-node-version`](https://github.com/ehmicky/preferred-node-version):\n  Get the preferred Node.js version of a project or user\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\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\"\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/node-version-alias/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/node-version-alias/commits?author=ehmicky\" title=\"Documentation\"\u003e📖\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\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/node-version-alias/commits?author=AdrieanKhisbe\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"https://github.com/ehmicky/node-version-alias/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\"\u003e\u003ca href=\"https://joram.dev\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/205834?v=4?s=100\" width=\"100px;\" alt=\"Joram van den Boezem\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eJoram van den Boezem\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/node-version-alias/issues?q=author%3Ahongaar\" title=\"Bug reports\"\u003e🐛\u003c/a\u003e\u003c/td\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"http://www.devalias.net/\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/753891?v=4?s=100\" width=\"100px;\" alt=\"Glenn 'devalias' Grant\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eGlenn 'devalias' Grant\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/ehmicky/node-version-alias/commits?author=0xdevalias\" title=\"Documentation\"\u003e📖\u003c/a\u003e \u003ca href=\"#question-0xdevalias\" title=\"Answering Questions\"\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","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fnode-version-alias","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fehmicky%2Fnode-version-alias","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fehmicky%2Fnode-version-alias/lists"}