Web 平台测试

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

运行测试

如果您使用的是 Windows 或您的系统不支持哈希邦，请在所有 ./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

# You can also filter which test files to run by specifying filters:
./tools/wpt.ts run -- streams/piping/general hr-time

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

更新启用的测试或预期

您可以通过更改 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 应该始终通过。

子命令

setup

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

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

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

--rebuild
    Rebuild the manifest instead of downloading. This can take up to 3 minutes.

--auto-config
    Automatically configure /etc/hosts if it is not configured (no prompt will be shown).

run

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

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

--release
    Use the ./target/release/deno binary instead of ./target/debug/deno

--quiet
    Disable printing of `ok` test cases.

--json=<file>
    Output the test results as JSON to the file specified.

您也可以通过在 -- 后指定一个或多个过滤器来指定要运行的具体测试。

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

update

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

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

--release
    Use the ./target/release/deno binary instead of ./target/debug/deno

--quiet
    Disable printing of `ok` test cases.

--json=<file>
    Output the test results as JSON to the file specified.

您也可以通过在 -- 后指定一个或多个过滤器来指定要运行的具体测试。

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

常见问题解答

升级 wpt 子模块：

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 的一部分。