To help you get started, we've collected the most common ways that compare-versions is being used within popular public projects.

machsix / Super-preloader / src / index.js View on Github

case "zh_CN":
                opts.text = SCRIPT_INFO["name-CN"] + " 从 v" + myOldVersion + " 升级到 v" + scriptInfo.version + "。";
                opts.text += upgradeNotification.text.zh_CN;
                break;

              default:
                opts.text = SCRIPT_INFO.name + " is upgraded from v" + myOldVersion + " to v" + scriptInfo.version + ". ";
                opts.text += upgradeNotification.text.en_US;
                break;
            }
            GM.notification(opts);
          }
        }
      }

      if (compareVersions(myOldVersion, scriptInfo.version) !== 0) {
        prefs.factoryCheck = true;
        // preSPinit.push(jsonRuleLoader.updateRule(true)); // rule is always updated after upgrade
        preSPinit.push(GM.setValue("version", scriptInfo.version));
        logger.info(`[UpdateCheck] version is updated ${myOldVersion} => ${scriptInfo.version}`);
      }

      let forceJsonUpdate = false;
      if (prefs.factoryCheck === true || prefs.factoryCheck === undefined) {
        const hasDifferent = assignDifferentProperty(prefs, prefsFactory);
        if (hasDifferent) {
          logger.info("[UpdateCheck] prefs is updated", prefs);
        }
        prefs.factoryCheck = false;
        preSPinit.push(GM.setValue("prefs", prefs));
        if (compareVersions(myOldVersion, scriptInfo.rewriteStorage) === -1) {
          preSPinit.push(GM.setValue("SITEINFO_D", SITEINFO_D));

View more ways to use compare-versions

compare-versions

Compare semver version strings to find greater, equal or lesser. Runs in the browser as well as Node.js/React Native etc. Has no dependencies and is tiny.

Supports the full semver specification including versions with different number of digits like 1.0.0, 1.0, 1 and pre-releases like 1.0.0-alpha. Additionally supports the following variations:

• Wildcards for minor and patch version like 1.0.x or 1.0.*.
• Chromium version numbers with 4 parts, e.g. version 25.0.1364.126.
• Any leading v is ignored, e.g. v1.0 is interpreted as 1.0.
• Leading zero is ignored, e.g. 1.01.1 is interpreted as 1.1.1.
• npm version ranges, e.g. 1.2.7 || >=1.2.9 <2.0.0

Install

$ npm install compare-versions

Note: Starting from v5 the main export is now named like so: import { compareVersions } from 'compare-versions'.

Note: Starting from v4 this library includes a ESM version which will automatically be selected by your bundler (webpack, parcel etc). The CJS/UMD version is lib/umd/index.js and the new ESM version is lib/esm/index.js.

Usage

Will return 1 if first version is greater, 0 if versions are equal, and -1 if the second version is greater:

import { compareVersions } from 'compare-versions';

compareVersions('11.1.1', '10.0.0'); //  1
compareVersions('10.0.0', '10.0.0'); //  0
compareVersions('10.0.0', '11.1.1'); // -1

Can also be used for sorting:

const versions = [
  '1.5.19',
  '1.2.3',
  '1.5.5'
]
const sorted = versions.sort(compareVersions);
/*
[
  '1.2.3',
  '1.5.5',
  '1.5.19'
]
*/

"Human Readable" Compare

The alternative compare function accepts an operator which will be more familiar to humans:

import { compare } from 'compare-versions';

compare('10.1.8', '10.0.4', '>');  // true
compare('10.0.1', '10.0.1', '=');  // true
compare('10.1.1', '10.2.2', '<');  // true
compare('10.1.1', '10.2.2', '<='); // true
compare('10.1.1', '10.2.2', '>='); // false

Version ranges

The satisfies function accepts a range to compare, compatible with npm package versioning:

import { satisfies } from 'compare-versions';

satisfies('10.0.1', '~10.0.0');  // true
satisfies('10.1.0', '~10.0.0');  // false
satisfies('10.1.2', '^10.0.0');  // true
satisfies('11.0.0', '^10.0.0');  // false
satisfies('10.1.8', '>10.0.4');  // true
satisfies('10.0.1', '=10.0.1');  // true
satisfies('10.1.1', '<10.2.2');  // true
satisfies('10.1.1', '<=10.2.2'); // true
satisfies('10.1.1', '>=10.2.2'); // false
satisfies('1.4.6', '1.2.7 || >=1.2.9 <2.0.0'); // true
satisfies('1.2.8', '1.2.7 || >=1.2.9 <2.0.0'); // false
satisfies('1.5.1', '1.2.3 - 2.3.4'); // true
satisfies('2.3.5', '1.2.3 - 2.3.4'); // false

Validate version numbers

Applies the same rules used comparing version numbers and returns a boolean:

import { validate } from 'compare-versions';

validate('1.0.0-rc.1'); // true
validate('1.0-rc.1');   // false
validate('foo');        // false

Validate version numbers (strict)

Validate version numbers strictly according to semver.org; 3 integers, no wildcards, no leading zero or "v" etc:

import { validateStrict } from 'compare-versions';

validate('1.0.0');      // true
validate('1.0.0-rc.1'); // true
validate('1.0');        // false
validate('1.x');        // false
validate('v1.02');      // false

Browser

If included directly in the browser, the functions above are available on the global window under the compareVersions object: