用途:为 workerd 测试框架编写 .wd-test 文件。该文件是 Cap'n Proto 配置,schema 定义于 src/workerd/server/workerd.capnp,用于定义测试 worker。
主要能力与用法:基础配置用 const unitTests 定义 services,worker 内用 modules 并通过 embed 内联文件,首个模块应命名为 "worker" 作为入口,compatibilityFlags 控制可用 API;wd-test 中不应使用 compatibilityDate,改用具体 flags。模块类型包括 esModule、json、wasm、commonJsModule。绑定通过 bindings 提供 env:text、data、json、service(含 entrypoint 的 RPC 绑定)、kvNamespace、durableObjectNamespace。测试 JS 导出带 test() 方法的命名对象,参数为 ctrl 和 env,可做同步或异步断言。BUILD.bazel 用 wd_test(),可传 args 与 data;每个 wd_test() 自动生成 @、@all-compat-flags、@all-autogates 三个变体,可用 just stream-test 运行指定变体,用 just new-test 脚手架生成测试文件。
高级配置:涉及 Durable Objects、多服务 service 绑定通信、出站网络访问、外部服务/socket 或 TypeScript 源文件时,需阅读 reference/advanced-configs.md,不应猜测高级语法。
限制:资料未提供具体兼容性标志清单、完整字段说明、版本要求或错误排查细节。