35 lines
1.4 KiB
Markdown
35 lines
1.4 KiB
Markdown
|
# latest-version
|
||
|
|
|
||
|
|
> Get the latest version of an npm package
|
||
|
|
|
||
|
|
Fetches the version directly from the registry instead of depending on the massive [npm](https://github.com/npm/npm/blob/8b5e7b6ae5b4cd2d7d62eaf93b1428638b387072/package.json#L37-L85) module like the [latest](https://github.com/bahamas10/node-latest) module does.
|
||
|
|
|
||
|
|
## Install
|
||
|
|
|
||
|
|
```sh
|
||
|
|
npm install latest-version
|
||
|
|
```
|
||
|
|
|
||
|
|
## Usage
|
||
|
|
|
||
|
|
```js
|
||
|
|
import latestVersion from 'latest-version';
|
||
|
|
|
||
|
|
console.log(await latestVersion('ava'));
|
||
|
|
//=> '6.1.1'
|
||
|
|
|
||
|
|
console.log(await latestVersion('@sindresorhus/df'));
|
||
|
|
//=> '4.0.0'
|
||
|
|
|
||
|
|
// Also works with semver ranges and dist-tags
|
||
|
|
console.log(await latestVersion('npm', {version: 'latest-5'}));
|
||
|
|
//=> '5.10.0'
|
||
|
|
```
|
||
|
|
|
||
|
|
This package exposes the [`version`](https://github.com/sindresorhus/package-json#version), [`registryUrl`](https://github.com/sindresorhus/package-json#registryurl), and [`omitDeprecated`](https://github.com/sindresorhus/package-json#omitdeprecated) options from [`package-json`](https://github.com/sindresorhus/package-json#options), as well as the [`PackageNotFoundError`](https://github.com/sindresorhus/package-json#packagenotfounderror) and [`VersionNotFoundError`](https://github.com/sindresorhus/package-json#versionnotfounderror) errors.
|
||
|
|
|
||
|
|
## Related
|
||
|
|
|
||
|
|
- [latest-version-cli](https://github.com/sindresorhus/latest-version-cli) - CLI for this module
|
||
|
|
- [package-json](https://github.com/sindresorhus/package-json) - Get the package.json of a package from the npm registry
|