npm Versioning

Identifier

npm

References

• https://semver.org/
• https://www.npmjs.com/package/semver
• https://docs.npmjs.com/about-semantic-versioning
• https://semver.npmjs.com/

Ranges/Constraints

✅ Ranges are supported.

Valid rangeStrategy values are: bump, widen, replace

Description

npm versioning is the most well known/widely-used implementation of Semantic Versioning 2.0.

It's important to understand that "npm" versioning scheme is not the same as "semver" versioning. SemVer's spec does not define ranges at all - so all range/constraint syntax in npm is npm-specific and not part of the spec.

---

Open items

The below list of bugs were current when this page was generated on December 15, 2025.

Bug reports

• npm versioning: support replace/widen of greater than - less than ranges #35619