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 se = require('semver-extra');

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

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

se.isStable(version)

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

Checks whether the version is a stable version.

se.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.

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

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

se.isExplicit(version)

se.isExplicit('1.0.0'); // true
se.isExplicit('^1.1.0'); // false

Checks whehter the version is an explicit version, i.e. it is not a range.

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

stable.max(versions)

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

Returns String the maximun version in the list.

stable.maxStable(versions)

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

Returns String the maximun stable version in the list.

stable.maxPrerelease(versions, [prerelease])

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

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

License

MIT