测试和工具

测试

测试 deno:

  1. # 运行所有测试套件:
  2. cargo test
  3. # 只测试 cli/js/:
  4. cargo test js_unit_tests

测试 std/:

  1. cargo test std_tests

代码检查与格式化

检查

  1. ./tools/lint.py

格式化

  1. ./tools/format.py

性能分析

  1. # 确认我们正在构建发布版 (release)。
  2. # 构建 deno 和 V8 的 d8。
  3. ninja -C target/release d8
  4. # 使用 --prof 选项运行想要分析的程序。
  5. ./target/release/deno run tests/http_bench.ts --allow-net --v8-flags=--prof &
  6. # 施加压力。
  7. third_party/wrk/linux/wrk http://localhost:4500/
  8. kill `pgrep deno`

V8 将在当前目录写入一个文件,像这样 isolate-0x7fad98242400-v8.log。查看这个文件:

  1. D8_PATH=target/release/ ./third_party/v8/tools/linux-tick-processor
  2. isolate-0x7fad98242400-v8.log > prof.log
  3. # 在 macOS 上, 使用 ./third_party/v8/tools/mac-tick-processor

prof.log 将包含不用调用的 tick 分布。

用 Web UI 查看这个日志,先生成 JSON 文件:

  1. D8_PATH=target/release/ ./third_party/v8/tools/linux-tick-processor
  2. isolate-0x7fad98242400-v8.log --preprocess > prof.json

在您的浏览器中打开 third_party/v8/tools/profview/index.html,选择 prof.json 以查看分布图。

在性能分析时有用的 V8 选项:

  • --prof
  • --log-internal-timer-events
  • --log-timer-events
  • --track-gc
  • --log-source-code
  • --track-gc-object-stats

有关 d8 和性能分析的更多信息,请查阅以下链接:

使用 LLDB 调试

Debugging with LLDB

  1. $ lldb -- target/debug/deno run tests/worker.js
  2. > run
  3. > bt
  4. > up
  5. > up
  6. > l

调试 Rust 代码,可以用 rust-lldb

  1. $ rust-lldb -- ./target/debug/deno run --allow-net tests/http_bench.ts
  2. # 在 macOS 上,您可能看到像这样的警告:
  3. # `ImportError: cannot import name _remove_dead_weakref`
  4. # 在这种情况下,设置 PATH 以使用系统 python,例如
  5. # PATH=/System/Library/Frameworks/Python.framework/Versions/2.7/bin:$PATH
  6. (lldb) command script import "/Users/kevinqian/.rustup/toolchains/1.36.0-x86_64-apple-darwin/lib/rustlib/etc/lldb_rust_formatters.py"
  7. (lldb) type summary add --no-value --python-function lldb_rust_formatters.print_val -x ".*" --category Rust
  8. (lldb) type category enable Rust
  9. (lldb) target create "../deno/target/debug/deno"
  10. Current executable set to '../deno/target/debug/deno' (x86_64).
  11. (lldb) settings set -- target.run-args "tests/http_bench.ts" "--allow-net"
  12. (lldb) b op_start
  13. (lldb) r

V8 选项

V8 有很多内部的命令行选项。

  1. # 列出可用的 V8 选项
  2. $ deno --v8-flags=--help
  3. # 使用多个选项的示例
  4. $ deno --v8-flags=--expose-gc,--use-strict

特别有用的:

  1. --async-stack-trace

持续的性能测试

参考我们的测试 https://deno.land/benchmarks

测试图表假设 https://github.com/denoland/benchmark_data/blob/gh-pages/data.json 有着 BenchmarkData[] 类型。以下是 BenchmarkData 的定义:

  1. interface ExecTimeData {
  2. mean: number;
  3. stddev: number;
  4. user: number;
  5. system: number;
  6. min: number;
  7. max: number;
  8. }
  9. interface BenchmarkData {
  10. created_at: string;
  11. sha1: string;
  12. benchmark: {
  13. [key: string]: ExecTimeData;
  14. };
  15. binarySizeData: {
  16. [key: string]: number;
  17. };
  18. threadCountData: {
  19. [key: string]: number;
  20. };
  21. syscallCountData: {
  22. [key: string]: number;
  23. };
  24. }