Compare Versions - semver

npm/semver/Compare Versions

View on npm

→Compare

7.8.5

7.8.5 (2026-06-19)

Bug Fixes

• 9c8692a #878 include prereleases in tilde range lower bound with includePrerelease (#878) (@chatman-media)

7.8.4

7.8.4 (2026-06-09)

Bug Fixes

• e583226 #874 reject numeric segments after x-ranges (@pupuking723)

7.8.3

7.8.3 (2026-06-08)

Bug Fixes

• 046da7f #872 align caret includePrerelease lower bounds (#872) (@wayyoungboy)

Chores

• 3485dda #866 bump @npmcli/eslint-config from 6.0.1 to 7.0.0 (#866) (@dependabot[bot])

7.8.2

7.8.2 (2026-06-04)

Bug Fixes

• bea6028 #870 increment dotted prerelease identifiers (#870) (@liuzemei, @SheldonNeo)

7.8.1

7.8.1 (2026-05-21)

Bug Fixes

• 17aa702 #869 strip build metadata before comparator trimming (#869) (@owlstronaut)
• 5f3ca13 #867 handle prerelease bounds in subset (#867) (@puneetdixit200, Puneet Dixit)

7.8.0

7.8.0 (2026-05-08)

Features

• 0d0a0a2 #855 Add truncate function (#855) (@pjohnmeyer, @owlstronaut)

Bug Fixes

• 3905343 #859 Warn when defaulting to --inc=patch in CLI (@pjohnmeyer)

Documentation

• c368af6 #853 fix typos in documentation (#853) (@ankitkumar572005)
• 37776c3 #846 fix BNF grammar to distinguish prerelease from build identifiers (#846) (@abhu85, @claude)

Chores

• 9542e09 #860 template-oss-apply (@owlstronaut)
• 937bc2c #860 template-oss-apply@5.0.0 (@owlstronaut)
• 6946fef #852 bump @npmcli/template-oss from 4.29.0 to 4.30.0 (#852) (@dependabot[bot], @npm-cli-bot)

7.7.4

7.7.4 (2026-01-16)

Bug Fixes

• a29faa5 #835 cli: pass options to semver.valid() for loose version validation (#835) (@mldangelo)

Documentation

• 1d28d5e #836 fix typos and update -n CLI option documentation (#836) (@mldangelo)

Dependencies

• 120968b #840 @npmcli/template-oss@4.29.0 (#840)

Chores

• 44d7130 #824 bump @npmcli/eslint-config from 5.1.0 to 6.0.0 (#824) (@dependabot[bot])
• 7073576 #820 reorder parameters in invalid-versions.js test (#820) (@reggi)
• 5816d4c #829 bump @npmcli/template-oss from 4.28.0 to 4.28.1 (#829) (@dependabot[bot], @npm-cli-bot)

7.7.3

7.7.3 (2025-10-06)

Bug Fixes

• e37e0ca #813 faster paths for compare (#813) (@H4ad)
• 2471d75 #811 x-range build metadata support (i529015)

Chores

• 8f05c87 #807 bump @npmcli/template-oss from 4.25.0 to 4.25.1 (#807) (@dependabot[bot], @owlstronaut)

7.7.2

7.7.2 (2025-05-12)

Bug Fixes

• fcafb61 #780 add missing 'use strict' directives (#780) (@Fdawgs)
• c99f336 #781 prerelease identifier starting with digits (#781) (@mbtools)

Chores

• c760403 #784 template-oss-apply for workflow permissions (#784) (@wraithgar)
• 2677f2a #778 bump @npmcli/template-oss from 4.23.6 to 4.24.3 (#778) (@dependabot[bot], @npm-cli-bot)

7.7.1

7.7.1 (2025-02-03)

Bug Fixes

• af761c0 #764 inc: fully capture prerelease identifier (#764) (@wraithgar)

7.7.0

7.7.0 (2025-01-29)

Features

• 0864b3c #753 add "release" inc type (#753) (@mbtools)

Bug Fixes

• d588e37 #755 diff: fix prerelease to stable version diff logic (#755) (@eminberkayd, berkay.daglar)
• 8a34bde #754 add identifier validation to inc() (#754) (@mbtools)

Documentation

• 67e5478 #756 readme: added missing period for consistency (#756) (@shaymolcho)
• 868d4bb #749 clarify comment about obsolete prefixes (#749) (@mbtools, @ljharb)

Chores

• 145c554 #741 bump @npmcli/eslint-config from 4.0.5 to 5.0.0 (@dependabot[bot])
• 753e02b #747 bump @npmcli/template-oss from 4.23.3 to 4.23.4 (#747) (@dependabot[bot], @npm-cli-bot)
• 0b812d5 #744 postinstall for dependabot template-oss PR (@hashtagchris)

7.6.3

7.6.3 (2024-07-16)

Bug Fixes

• 73a3d79 #726 optimize Range parsing and formatting (#726) (@jviide)

Documentation

• 2975ece #719 fix extra backtick typo (#719) (@stdavis)

7.6.2

7.6.2 (2024-05-09)

Bug Fixes

• 6466ba9 #713 lru: use map.delete() directly (#713) (@negezor, @lukekarrys)

7.6.1

7.6.1 (2024-05-04)

Bug Fixes

• c570a34 #704 linting: no-unused-vars (@wraithgar)
• ad8ff11 #704 use internal cache implementation (@mbtools)
• ac9b357 #682 typo in compareBuild debug message (#682) (@mbtools)

Dependencies

• 988a8de #709 uninstall lru-cache (#709)
• 3fabe4d #704 remove lru-cache

Chores

• dd09b60 #705 bump @npmcli/template-oss to 4.22.0 (@lukekarrys)
• ec49cdc #701 chore: chore: postinstall for dependabot template-oss PR (@lukekarrys)
• b236c3d #696 add benchmarks (#696) (@H4ad)
• 692451b #688 various improvements to README (#688) (@mbtools)
• 5feeb7f #705 postinstall for dependabot template-oss PR (@lukekarrys)
• 074156f #701 bump @npmcli/template-oss from 4.21.3 to 4.21.4 (@dependabot[bot])

7.6.0

7.6.0 (2024-01-31)

Features

• a7ab13a #671 preserve pre-release and build parts of a version on coerce (#671) (@madtisa, madtisa, @wraithgar)

Chores

• 816c7b2 #667 postinstall for dependabot template-oss PR (@lukekarrys)
• 0bd24d9 #667 bump @npmcli/template-oss from 4.21.1 to 4.21.3 (@dependabot[bot])
• e521932 #652 postinstall for dependabot template-oss PR (@lukekarrys)
• 8873991 #652 chore: chore: postinstall for dependabot template-oss PR (@lukekarrys)
• f317dc8 #652 bump @npmcli/template-oss from 4.19.0 to 4.21.0 (@dependabot[bot])
• 7303db1 #658 add clean() test for build metadata (#658) (@jethrodaniel)
• 6240d75 #656 add missing quotes in README.md (#656) (@zyxkad)
• 14d263f #625 postinstall for dependabot template-oss PR (@lukekarrys)
• 7c34e1a #625 bump @npmcli/template-oss from 4.18.1 to 4.19.0 (@dependabot[bot])
• 123e0b0 #622 postinstall for dependabot template-oss PR (@lukekarrys)
• 737d5e1 #622 bump @npmcli/template-oss from 4.18.0 to 4.18.1 (@dependabot[bot])
• cce6180 #598 postinstall for dependabot template-oss PR (@lukekarrys)
• b914a3d #598 bump @npmcli/template-oss from 4.17.0 to 4.18.0 (@dependabot[bot])

7.5.4

7.5.4 (2023-07-07)

Bug Fixes

• cc6fde2 #588 trim each range set before parsing (@lukekarrys)
• 99d8287 #583 correctly parse long build ids as valid (#583) (@lukekarrys)

7.5.3

7.5.3 (2023-06-22)

Bug Fixes

• abdd93d #571 set max lengths in regex for numeric and build identifiers (#571) (@lukekarrys)

Documentation

• bf53dd8 #569 add example for > comparator (#569) (@mbtools)

7.5.2

7.5.2 (2023-06-15)

Bug Fixes

• 58c791f #566 diff when detecting major change from prerelease (#566) (@lukekarrys)
• 5c8efbc #565 preserve build in raw after inc (#565) (@lukekarrys)
• 717534e #564 better handling of whitespace (#564) (@lukekarrys)

7.5.1

7.5.1 (2023-05-12)

Bug Fixes

• d30d25a #559 show type on invalid semver error (#559) (@tjenkinson)

7.5.0

7.5.0 (2023-04-17)

Features

• 503a4e5 #548 allow identifierBase to be false (#548) (@lsvalina)

Bug Fixes

• e219bb4 #552 throw on bad version with correct error message (#552) (@wraithgar)
• fc2f3df #546 incorrect results from diff sometimes with prerelease versions (#546) (@tjenkinson)
• 2781767 #547 avoid re-instantiating SemVer during diff compare (#547) (@macno)

7.4.0

7.4.0 (2023-04-10)

Features

• 113f513 #532 identifierBase parameter for .inc (#532) (@wraithgar, @b-bly)
• 48d8f8f #530 export new RELEASE_TYPES constant (@hcharley)

Bug Fixes

• 940723d #538 intersects with v0.0.0 and v0.0.0-0 (#538) (@wraithgar)
• aa516b5 #535 faster parse options (#535) (@H4ad)
• 61e6ea1 #536 faster cache key factory for range (#536) (@H4ad)
• f8b8b61 #541 optimistic parse (#541) (@H4ad)
• 796cbe2 #533 semver.diff prerelease to release recognition (#533) (@wraithgar, @dominique-blockchain)
• 3f222b1 #537 reuse comparators on subset (#537) (@H4ad)
• f66cc45 #539 faster diff (#539) (@H4ad)

Documentation

• c5d29df #530 Add "Constants" section to README (@hcharley)

7.3.8

7.3.8 (2022-10-04)

Bug Fixes

• d8ef32c #383 add support for node.js esm auto exports (#383) (@MylesBorins)

Documentation

• 7209b14 #477 update range.js comments to clarify the caret ranges examples (#477) (@amitse)

7.3.7

7.3.7 (2022-04-11)

Bug Fixes

• allow node >=10 (85b269a)
• bin: get correct value from arg separated by equals (#449) (4ceca76), closes #431
• ensure SemVer instance passed to inc are not modified (#427) (f070dde)
• inc prerelease with numeric preid (#380) (802e161)

Dependencies

• revert to lru-cache@6 (22ae54d)

7.3.6

7.3.6 (2022-04-05)

Bug Fixes

• https://github.com/npm/node-semver/issues/329 (cb1ca1d)
• properly escape dots in GTE0 regexes (#432) (11494f1)
• replace deprecated String.prototype.substr() (#445) (e2d55e7)
• replace regex used to split ranges (#434) (9ab7b71)

Documentation

• clarify * range behavior (cb1ca1d)

Dependencies

• lru-cache@7.4.0 (#442) (9a3064c)
• tap@16.0.0 (#439) (60cbb3f)

6.3.1

6.3.1 (2023-07-10)

Bug Fixes

• 928e56d #591 better handling of whitespace (#591) (@lukekarrys, @joaomoreno, @nicolo-ribaudo)

5.7.2

5.7.2 (2023-07-10)

Bug Fixes

• 2f8fd41 #585 better handling of whitespace (#585) (@joaomoreno, @lukekarrys)