RxJS 9 发布门禁Release Gates全解运行时矩阵、CI 归属、分发契约与性能/体积预算【免费下载链接】rxjsA reactive programming library for JavaScript项目地址: https://gitcode.com/gh_mirrors/rx/rxjs本文基于 packages/rxjs/docs/RELEASE_GATES.md 展开。RxJS 9 预发布线当前版本9.0.0-beta.0用一套可执行的门禁系统来回答这个候选版本能不能发布在哪些运行时上必须通过Blocking、由哪些 CI 工作流负责、消费者拿到的是什么样的分发制品、以及体积与吞吐必须守住哪些预算。读完本文你将能逐条执行仓库内的发布门禁命令理解每条门禁背后对应的测试脚本与源码实现并掌握如何解读迁移证据基线、浏览器/Safari 契约与打包采纳检查的结果。这套门禁只负责合格化qualify一个候选版本永远不会授权直接发布——版本选择、精确 tarball 合格化、npm 分阶段批准、WebAuthn 顺序与失败恢复均由仓库的安全发布手册定义。门禁的定位合格化而非授权发布发布门禁是 RxJS 9 预发布线prerelease line的可执行环境与包门禁executable environment and package gates文档。它是包级文档不依赖仓库中的文档站点应用apps/rxjs.dev。核心分工如下版本选择、精确 tarball 合格化、npm 分阶段批准、WebAuthn 认证顺序与失败恢复由 docs/RELEASE_PROCESS.md 定义的发布流程负责候选版本的合格化由本文描述的运行时矩阵、CI 归属、分发契约与预算共同完成。一句话总结门禁回答这个候选是否合格发布流程回答合格之后如何安全地发布。两者结合确保任何发布动作都经过环境验证与人工/自动化授权而不是CI 绿了就直推 npm。运行时矩阵哪些环境必须通过下表完整继承原文档的运行时矩阵。其中可执行证据Executable evidence列说明该环境下具体跑什么检查环境发布角色可执行证据Node 22.13.0阻塞Blocking包构建、类型、ESM 导入、Noderequire(esm)、运行时契约Node 24阻塞Blocking完整包与发布门禁外加锁定版本的 Observable WPTNode 26测试版期间建议Advisory同样的包与运行时门禁CI 结果为非阻塞当前 Chrome 与 Firefox阻塞Blocking八用例浏览器生命周期与 Symbol 扩展契约当前桌面版 Safari阻塞Blocking通过 Apple SafariDriver 执行同样的契约当前移动版 Safari阻塞Blocking通过 Apple SafariDriver 在真实 iOS 模拟器中执行同样的契约当前 Playwright WebKit附加信号Additional signal同样的契约但以 WebKit 而非品牌化 Safari 上报Deno 2.8.0阻塞Blocking包构建后的运行时契约Bun 1.3.14阻塞Blocking包构建后的运行时契约Webpack 5.106.2阻塞BlockingESM 解析、生产模式执行、输出体积预算配套约束发布一致性检查器release-coherence checker会锁定具体的 Deno、Bun、Webpack、浏览器、Node 与 Safari CI 通道版本。因此升级某个当前运行时的版本不是静默漂移silent drift而是一次需要评审的发布变更——防止 CI 在无人察觉的情况下换到一套行为不同的新运行时。从源码看运行时契约的具体断言Node 22.13.0门禁中的运行时契约对应 packages/rxjs/test/release/runtime-contract.mjs它真实地在目标运行时里做如下断言必备原生原语存在AbortController、AbortSignal、EventTarget、WeakRef以及AbortSignal.any、Symbol.disposeglobalThis.Observable是函数RxJS 要么选择了平台 Observable要么安装了 polyfillSymbol 操作符管线可用ColdObservablepipe/map/scan的 Symbol 调用链必须产生[2, 6, 12]Subject 取消abort语义正确订阅后next(first)、controller.abort()、再next(ignored)最终只收到[first]通过import.meta.resolve(rxjs/map)验证解析结果必须指向dist/esm/map.js——即运行时消费的一定是 ESM 制品输出当前运行时身份Node / Deno / Bun 及版本。该脚本同时是 Deno 2.8.0 与 Bun 1.3.14 阻塞门禁的执行体文档明确说明 Deno/Bun 支持只增加测试基础设施不增加运行时代码、依赖、导出条件或 bundle 字节脚本头部直接以import { ColdObservable, Subject } from rxjs消费包构建产物见 runtime-contract.mjs。CI 归属四个工作流各守什么原文档的 CI 归属矩阵完整如下工作流拉取请求Pull requestsmaster推送主 CIMain CI包矩阵 精确迁移证据与工具链每次推送执行同样的阻塞门禁最新版 TypeScript针对最新 TypeScript 编译 RxJS每次推送给出同样的兼容性信号Observable WPT当平台、包或 harness 路径变更时阻塞每次推送阻塞执行锁定的符合性conformance检查发布就绪Release readiness当发布包、脚本或配置变更时阻塞每次推送执行完整阻塞环境矩阵主 CI 的职责远不止跑测试迁移证据全量执行在 cold 与 polyfill 两种模式下运行全部 2,338 个源码锁定source-pinned的 RxJS 7 证据用例并要求与已评审的 2,299/39cold 模式 pass/fail与 2,316/22polyfill 模式 pass/fail用例 ID 集合精确相等有意的偏差仍是失败裸审计命令会把有意的分歧intentional divergences当作普通失败上报CI 校验器会阻止任何新增失败、意外通过、收集不完整、身份漂移进入基线直到证据被人工评审附带职责生成的证据新鲜度generated evidence freshness、bundle 分析测试、SafariDriver 单元测试与活跃工作流校验发布一致性拒绝删除必需的命令、通道或master触发条件。证据基线的源码实现精确相等在 packages/rxjs/test/ported/tools/check-mode-audits.mjs 中落地该脚本对cold与polyfill两种模式分别运行审计环境变量RXJS_NEXT_AUDIT_ONLY1RXJS_NEXT_TEST_MODE对不完整的审计文件单独重跑最后把实际结果与verified-cold-passes.json、verified-polyfill-passes.json做基线比对assertAuditBaseline输出形如Validated exact cold audit baseline: 2338 cases, 2299 passing, 39 failing.的结论。配套基线文件位于 packages/rxjs/test/ported/verified-cold-passes.json 与 packages/rxjs/test/ported/verified-polyfill-passes.json。需要特别强调的是完整迁移语料库是证据不是RxJS 9 实现了 RxJS 7 的全部行为的声明。其评审过的有意分歧按设计保持非零真正阻塞发布的是聚焦源码套件、包门禁、运行时矩阵与符合性套件。分发契约唯一 ESM 制品无 CommonJS原文档的分发契约非常明确也是理解 RxJS 9 包结构的关键所有受支持的消费者拿到同一份dist/esmJavaScript。浏览器、Webpack、ESMimport与 Noderequire(esm)的导出条件export conditions不会选择目标特定副本Deno 与 Bun 支持仅增加测试基础设施不增加运行时代码、依赖、导出条件或 bundle 字节没有 CommonJS 制品。require(rxjs)仅通过 Node 22.13 的require(esm)桥支持并返回与 ESM 导入相同的模块身份与完全相同的 Symbols。仓库证据与之一致在 packages/rxjs/package.json 中type: module、engines: { node: 22.13.0 }而exports下browser、webpack、import、require四个条件全部指向同一个./dist/esm/index.js类型为./dist/esm/index.d.ts。tshy 配置也只声明了dialects: [esm]。Webpack 门禁进一步强制这一点见下节。预算体积、吞吐与 tarball 上限预算固化在 packages/rxjs/test/release/budgets.json 中全部是阻塞性的指标预算字段名代表性压缩 Webpack bundle≤ 22,000 字节webpackBytesmap 管线中位数吞吐≥ 5,000,000 值/秒mapValuesPerSecond订阅-取消循环中位数≥ 30,000 次取消/秒cancellationsPerSecondrxjstarball 250,000 字节packageTarballBytes.rxjsrxjs/observable-polyfilltarball 30,000 字节packageTarballBytes[rxjs/observable-polyfill]rxjs/testtarball 60,000 字节packageTarballBytes[rxjs/test]rxjs/migratetarball 140,000 字节packageTarballBytes[rxjs/migrate]原文档给出的初始 Node 24 证据Webpack 17,502 字节、约 5,040 万值/秒的 map 吞吐、约 14.05 万次取消/秒。预算设计意图明确吞吐下限刻意留有充分的 runner 余量bundle 上限则留出约 25% 的增长空间同时仍能捕获重复方言duplicate dialect或大型意外依赖。性能预算如何测量源码级packages/rxjs/test/release/performance.mjs 实现了吞吐门禁对 map 管线25 万值与取消循环2 万次各采样 5 轮取中位数低于预算即抛错。它直接使用ColdObservable与 Symbol 操作符map与运行时契约同源——测的是真实发布产物的能力。Webpack 门禁如何验证分发契约packages/rxjs/test/release/webpack.mjs 在临时目录里 symlinkpackages/rxjs作为node_modules/rxjs用webpack 5.106.2以mode: production、experiments.outputModule、conditionNames: [webpack, browser, import, default]编译入口然后断言编译无 error/warning实际消费的模块来自packages/rxjs/dist/esm/不消费任何dist/browser、dist/commonjs、dist/webpack副本即无重复方言产物bundle.mjs大小 ≤budgets.webpackBytes用当前 Node 直接执行产物验证生产模式下运行时行为正确[1] 1 → [2]。命令速查逐条执行发布门禁以下命令从仓库根目录执行对应 package.json 与 packages/rxjs/package.json 中的脚本定义pnpm run release:check pnpm --filter rxjs run test:unit:audit:check pnpm run test:bundle-analysis pnpm run test:release:safari pnpm run test:workflows pnpm run test:release:runtime pnpm run test:release:browsers pnpm run test:release:safari pnpm run test:release:webpack pnpm run test:release:performance pnpm run test:release:adoption pnpm run test:wpt各命令对应实现与职责命令底层实现职责release:checkscripts/release/release-doctor.mjs、scripts/check-release-coherence.mjs、scripts/check-package-docs.mjs 等一组 node --test发布医生 一致性/文档/安全基线总检test:unit:audit:checkpackages/rxjs/test/ported/tools/check-mode-audits.mjs校验 cold/polyfill 迁移证据基线精确相等test:bundle-analysisscripts/analyze-bundles.mjsbundle 结构分析test:release:safaripackages/rxjs/test/release/safari-driver.test.mjs、packages/rxjs/test/release/boot-ios-simulator.test.mjsSafariDriver 单元测试 iOS 模拟器启动测试test:workflowsprettier 校验.github/workflows/*.yml等活跃工作流格式与触发条件验证test:release:runtimepackages/rxjs/test/release/runtime-contract.mjsNode/Deno/Bun 运行时契约test:release:browserspackages/rxjs/test/release/browser-matrix.mjsPlaywright Chromium/Firefox/WebKit 浏览器契约test:release:webpackpackages/rxjs/test/release/webpack.mjsWebpack ESM 解析、生产执行与体积预算test:release:performancepackages/rxjs/test/release/performance.mjsmap 吞吐与取消吞吐预算test:release:adoptionscripts/qualify-prerelease.mjs预发布采纳packed-adoption门禁test:wptpackages/observable-polyfill/test/wpt/cli.mjs锁定的 Observable WPT 符合性浏览器契约与 Safari 特例桌面与移动版 Safari 的执行由 CI 持有因为 SafariDriver 需要宿主机级别的自动化授权。移动版 Safari 通道请求platformName: iOS与safari:useSimulator: truePlaywright WebKit 永远不会被用来替代品牌化 Safari 门禁。实现见 packages/rxjs/test/release/safari.mjsnode test/release/safari.mjs desktop|ios通过 SafariDriver 创建会话、注入 bundle、异步执行八用例契约并比对extensionKernelCaseNames。浏览器契约本身在 packages/rxjs/test/release/browser-contract.mjs用 esbuild 以conditions: [browser, import]、iife、es2022目标构建单文件 bundle把扩展内核extension kernel的契约执行函数注入页面后运行。Playwright 侧 packages/rxjs/test/release/browser-matrix.mjs 对 chromium/firefox/webkit 逐个启动无头浏览器、注入 bundle、执行同一契约并断言页面无错误WebKit 结果以 WebKit 而非 Safari 品牌上报。打包采纳门禁packed-adoption gate原文档强调打包采纳门禁把本地 tarball 安装进一个无注册表访问no registry access的隔离消费者然后依次运行ESM 导入app.mjsNoderequire(esm)require.cjsTypeScript 编译tsc -p tsconfig.jsonmarble 测试浏览器 bundleesbuild 压缩产物同样受webpackBytes预算约束此外它还会拒绝源码 spec、重复输出方言、缺失的包文档以及 tarball 体积回退。实现见 scripts/qualify-prerelease.mjs 与 scripts/prerelease-adoption-lib.mjs对rxjs、rxjs/observable-polyfill、rxjs/test、rxjs/migrate四个包执行npm pack --json并在临时目录离线安装npm install --offline随后逐项执行上述消费者场景。这一门禁模拟了真实用户从 tarball 而非 git 源码安装的完整体验。结论与适用前提RxJS 9 的发布门禁是一套分层的可执行证据系统运行时矩阵覆盖 Node 三线、三大浏览器、品牌化 Safari、Deno、Bun 与 WebpackCI 归属明确四个工作流在 PR 与master推送下的职责分发契约用单一dist/esm制品统一所有消费者并彻底移除 CommonJS预算用可复现的基准守住 bundle 体积、map 吞吐、取消吞吐与四个 tarball 的大小。适用前提提醒文中所有版本Node 22.13.0、Deno 2.8.0、Bun 1.3.14、Webpack 5.106.2、证据用例数2,338与初始性能数据17,502 字节、约 5,040 万值/秒、约 14.05 万取消/秒均以当前仓库为准且当前运行时版本升级本身就是一次需要评审的发布变更门禁只合格化候选绝不直接发布真正的发布动作遵循 docs/RELEASE_PROCESS.md 定义的安全发布手册迁移语料是证据而非完整实现 RxJS 7的承诺阻塞性检查是聚焦源码套件、包门禁、运行时矩阵与符合性套件。对 RxJS 9 的维护者与进阶使用者而言理解这套门禁就等于理解了RxJS 9 凭什么可以发布的完整答案对希望参与贡献的开发者逐条运行上述命令即可在本地复现 CI 的判定逻辑。【免费下载链接】rxjsA reactive programming library for JavaScript项目地址: https://gitcode.com/gh_mirrors/rx/rxjs创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考