VS Code Extension Test Runner：简化扩展开发测试

VS Code Extension Test Runner是一款专为其他扩展开发者设计的VS Code扩展工具，旨在简化扩展开发过程中的测试工作。它利用新的扩展测试API和配置文件，帮助开发者在开发过程中实时运行测试。更多信息，请参阅我们的扩展开发者测试指南。

快速上手

请按照扩展开发者测试指南的说明，通过命令行初步设置测试。然后，安装此扩展。

此扩展会自动发现并处理工作区中的.vscode-test.js/mjs/cjs文件，几乎不需要额外的配置。它通过检查JavaScript代码中的测试文件来工作。如果您使用TypeScript编写测试，您需要：

1. 修改tsconfig.json文件，并添加"sourceMap": true
2. 在.vscodeignore文件中添加*/.js.map，以避免发布扩展时文件膨胀。

配置选项

• extension-test-runner.extractSettings：配置如何提取测试。您可以配置：

  • 提取模式（extractWith），指定是通过评估还是语法树解析来提取测试。评估方式可能带来更好的结果，但可能有副作用。默认使用评估方式。
  • 提取的测试和套件标识符。默认分别为["it", "test"]和["describe", "suite"]，涵盖Mocha的常用接口。

• extension-test-runner.debugOptions：调试扩展时传递的选项，通常在launch.json中找到。请参阅文档以获取完整的选项列表。

• extension-test-runner.wrapper：在非调试模式下运行VS Code时使用的包装脚本。运行测试时，参数将传递给此脚本，并应将第一个参数作为子进程启动。

  常见的用例是将其设置为xvfb-run，用于没有显示的远程环境，以避免“缺少显示”错误。

贡献指南

此项目欢迎贡献和建议。大多数贡献需要您同意贡献者许可协议（CLA），声明您有权并实际授予我们使用您的贡献的权利。详情请访问https://cla.opensource.microsoft.com。

当您提交拉取请求时，CLA机器人将自动确定您是否需要提供CLA，并适当装饰PR（例如，状态检查、评论）。只需按照机器人提供的说明操作。您只需在使用我们CLA的所有仓库中执行一次此操作。

此项目已采用微软开源行为准则。更多信息请参阅行为准则常见问题解答，或通过opencode@microsoft.com联系我们，提出任何额外的问题或评论。

商标信息

此项目可能包含项目、产品或服务的商标或标志。授权使用微软商标或标志需遵守微软的商标和品牌指南。在此项目的修改版本中使用微软商标或标志不得引起混淆或暗示微软的赞助。任何第三方商标或标志的使用需遵守该第三方的政策。