Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

test262 与测试

test262

tests/test262 是 tc39/test262 子模块(浅克隆,git submodule update --init 拉取), 运行器 tests/test262.rs 是根包的测试(harness = false,不发布)。

cargo test --release --test test262                                                   # 只跑基线里的用例,掉了就失败
cargo test --release --test test262 -- language/expressions/addition built-ins/Math   # 跑这些目录
J8_TEST262_JIT=1 cargo test --release --test test262                                  # 开 JIT(每个函数第一次调用就编)对拍
J8_TEST262_VERBOSE=1 cargo test --release --test test262 -- <路径>                     # 逐条列出没过的原因
J8_TEST262_UPDATE=1 cargo test --release --test test262 -- <路径>                      # 结果写回基线
  • 每个用例一个子进程、10 秒超时;结果分 pass / fail / unsupported(j8 报 Error::Unsupported)/ skip / timeout / crash,按目录汇总;
  • 基线 tests/test262.passing:过了的用例一行一个,当前 42,443 行;不带参数时只跑它做回归检查;
  • 非严格模式与 onlyStrict(严格模式跑);模块用例先跑 harness 脚本再跑模块;
  • $262 宿主对象提供 global / evalScript / gc / detachArrayBuffer(createRealm 抛 TypeError);
  • 不支持写法的报错行号含拼进去的 harness。

每次提交零回归是 j8 的硬规矩,开着 JIT 也要过同一份基线(JIT 阈值设成 0,每个函数第一次调用就编,最大化覆盖)。

其他测试

测试内容
tests/runtime.rs、tests/event_loop.rs、tests/terminate.rs运行时、事件循环、中止执行
tests/binding.rs、tests/bindings_more.rs绑定宏
crates/j8bytecode/tests/v8.rs解码 V8 打印的 738 条指令,逐条核对
crates/j8executor 的 javascript_semantics逐条确定的 JS 语义表
crates/j8jit/tests、j8taskqueue/tests、j8lockfree/tests、j8napi/tests各 crate 自己的测试
samples/workerd/tests聊天室压测、一千个 Worker
samples/jumpheap/tests/three.rs三进程跨堆矩阵

怎么加一个特性

路线图里每一阶段的流程:

  1. 先往语义表加用例;
  2. clippy 干净;
  3. 在快照里跑 test262 基线,零回归;
  4. 用 J8_TEST262_UPDATE=1 把相关目录里新通过的用例记进基线;
  5. 提交、推送(j8 在 GitHub 上走分支 + PR)。

单元测试只钉确定的事实,每次只跑一个,用 timeout 15 限时。