Bun 实现了语义化版本控制 API,可用于比较版本并确定某个版本是否与另一个版本范围兼容。版本和范围的设计与 node-semver 兼容,后者被 npm 客户端使用。
它的速度比 node-semver 快约 20 倍。
目前,此 API 提供两个函数:
Bun.semver.satisfies(version: string, range: string): boolean
如果 version 满足 range 则返回 true,否则返回 false。
示例:
typescript
import { semver } from "bun";
semver.satisfies("1.0.0", "^1.0.0"); // true
semver.satisfies("1.0.0", "^1.0.1"); // false
semver.satisfies("1.0.0", "~1.0.0"); // true
semver.satisfies("1.0.0", "~1.0.1"); // false
semver.satisfies("1.0.0", "1.0.0"); // true
semver.satisfies("1.0.0", "1.0.1"); // false
semver.satisfies("1.0.1", "1.0.0"); // false
semver.satisfies("1.0.0", "1.0.x"); // true
semver.satisfies("1.0.0", "1.x.x"); // true
semver.satisfies("1.0.0", "x.x.x"); // true
semver.satisfies("1.0.0", "1.0.0 - 2.0.0"); // true
semver.satisfies("1.0.0", "1.0.0 - 1.0.1"); // true如果 range 无效,则返回 false。如果 version 无效,则返回 false。
Bun.semver.order(versionA: string, versionB: string): 0 | 1 | -1
如果 versionA 和 versionB 相等则返回 0,如果 versionA 大于 versionB 则返回 1,如果 versionA 小于 versionB 则返回 -1。
示例:
typescript
import { semver } from "bun";
semver.order("1.0.0", "1.0.0"); // 0
semver.order("1.0.0", "1.0.1"); // -1
semver.order("1.0.1", "1.0.0"); // 1
const unsorted = ["1.0.0", "1.0.1", "1.0.0-alpha", "1.0.0-beta", "1.0.0-rc"];
unsorted.sort(semver.order); // ["1.0.0-alpha", "1.0.0-beta", "1.0.0-rc", "1.0.0", "1.0.1"]
console.log(unsorted);如果你需要其他 semver 函数,请随时提出问题或拉取请求。