Web 平台测试

Deno 使用自定义的测试运行器来执行 Web 平台测试。它位于 ./tools/wpt.ts。

运行测试 Jump to heading#

如果您在 Windows 上，或者您的系统不支持 hashbangs，请在所有 ./tools/wpt.ts 命令前加上 deno run --unstable --allow-write --allow-read --allow-net --allow-env --allow-run。

在首次尝试运行 WPT 测试之前，请先运行 WPT 设置。每次更新 ./test_util/wpt 子模块时，也必须运行此命令：

./tools/wpt.ts setup

要运行所有可用的 Web 平台测试，请运行以下命令：

./tools/wpt.ts run

# 您还可以通过指定过滤器来筛选要运行的测试文件：
./tools/wpt.ts run -- streams/piping/general hr-time

测试运行器将运行每个 Web 平台测试并记录其状态（失败或通过）。然后，它会将此输出与 ./tools/wpt/expectation.json 文件中指定的每个测试的预期输出进行比较。该文件是一个嵌套的 JSON 结构，与 ./test_utils/wpt 目录相对应。它描述了每个测试文件是否应整体通过（所有测试通过，true），是否应整体失败（测试运行器在测试之外遇到异常或所有测试失败，false），或者哪些测试预期会失败（测试用例名称的字符串数组）。

更新启用的测试或期望 Jump to heading#

您可以通过更改 JSON 结构中每个测试文件条目的值来手动更新 ./tools/wpt/expectation.json 文件。另一种更推荐的方法是让 WPT 运行器运行所有或筛选后的测试子集，然后自动更新 expectation.json 文件以匹配当前实际情况。您可以使用 ./wpt.ts update 命令来实现这一点。例如：

./tools/wpt.ts update -- hr-time

运行此命令后，expectation.json 文件将与所有已运行测试的当前输出匹配。这意味着在运行 wpt.ts update 后立即运行 wpt.ts run 应该总是通过。

子命令 Jump to heading#

setup Jump to heading#

验证您的环境是否配置正确，或帮助您进行配置。

这将检查 python3（或在 Windows 上是 python.exe）是否确实是 Python 3。

您可以指定以下标志来自定义行为：

--rebuild
    重新构建清单而不是下载。这可能需要长达 3 分钟。

--auto-config
    如果未配置 /etc/hosts，则自动配置（不会显示提示）。

run Jump to heading#

按照 expectation.json 中的指定运行所有测试。

您可以指定以下标志来自定义行为：

--release
    使用 ./target/release/deno 二进制文件而不是 ./target/debug/deno。

--quiet
    禁用打印 `ok` 测试用例。

--json=
    将测试结果以 JSON 格式输出到指定文件。

您还可以通过在 -- 后指定一个或多个过滤器来精确指定要运行的测试：

./tools/wpt.ts run -- hr-time streams/piping/general

update Jump to heading#

更新 expectation.json 以匹配当前实际情况。

您可以指定以下标志来自定义行为：

--release
    使用 ./target/release/deno 二进制文件而不是 ./target/debug/deno。

--quiet
    禁用打印 `ok` 测试用例。

--json=
    将测试结果以 JSON 格式输出到指定文件。

您还可以通过在 -- 后指定一个或多个过滤器来精确指定要运行的测试：

./tools/wpt.ts update -- hr-time streams/piping/general

常见问题 Jump to heading#

升级 wpt 子模块： Jump to heading#

cd test_util/wpt/
git fetch origin
git checkout origin/epochs/daily
cd ../../
git add ./test_util/wpt

所有贡献者在此之后都需要重新运行 ./tools/wpt.ts setup。

由于升级 WPT 通常需要更新期望以涵盖各种上游更改，最好将其作为一个单独的 PR 进行，而不是作为实现修复或功能的 PR 的一部分。