Package Exports

semver-extra

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (semver-extra) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

semver-extra

semver-extra contains useful methods that aren't included in the vanilla semver package.

The main reason semver-extra exists is to deal with pre-release versions.

Install

$ npm install semver-extra --save

Usage

var semver = require('semver-extra');

First of all, semver-extra contains all methods of semver@4.x, so we could use semver-extra only without the vanilla one.

semver.validRange('^1.2.3'); // '>=1.2.3-0 <2.0.0-0'

semver.isStable(version)

semver.isStable('1.2.3');        // -> true
semver.isStable('1.2.3-stable'); // -> false
semver.isStable('1.2.3-alpha');  // -> false

Checks whether the version is a stable version.

semver.isPrerelease(version, [prerelease])

version string
prerelease String=
- If argument prerelease is not passed and version is an unstable version, it will return true.
- or prerelease could be the pre-release string.

semver.isPrerelease('1.2.3'); // false
semver.isPrerelease('1.2.3-beta'); // true
semver.isPrerelease('1.2.3-beta', 'alpha'); // false
semver.isPrerelease('1.2.3-1.2.3', '1.2.3'); // true, that supports numeric prerelease versions
semver.isPrerelease('1.2.3-alpha.1', 'alpha.1'); // true

Checks whether the version is an unstable version or matches the prerelease.

var versions = [
  '1.1.2'
  '1.2.3-beta',
  '1.2.2',
  '1.2.1',
  '1.3.3',
  '1.5.0-rc'
];

semver.max(versions)

semver.max(versions); // '1.5.0-rc'

Returns String the maximun version in the list.

semver.maxStable(versions)

semver.maxStable(versions); // '1.3.3'

Returns String the maximun stable version in the list.

semver.maxPrerelease(versions, [prerelease])

semver.maxPrerelease(versions, 'alpha'); // null
semver.maxPrerelease(versions); // '1.5.0-rc'
semver.maxPrerelease(versions, 'beta'); // '1.2.3-beta'

Returns the maximun (matched) pre-release version matches the prerelease.

License

MIT