无头 Chrome 调试#

一些Bokeh 的 JavaScript 测试包括使用 Chrome 的无头版本运行全自动测试。对于本地测试，尤其是在运行和更新特定测试时，使用 Chrome 的 GUI 手动运行这些测试。

在大多数情况下，使用 Chrome 的 GUI 在本地运行测试的结果与在 CI 中使用无头 Chrome 运行测试的结果相同。但是，在极少数情况下，无头 Chrome 和 GUI Chrome 会生成不同的结果。在这种情况下，您无法使用 GUI - 相反，您需要直接在无头浏览器中调试 BokehJS 的代码。

注意

以下说明仅适用于您确实需要专门在 Chrome 的无头版本中进行调试的极少数情况。在大多数情况下，您应该能够使用 Chrome 的 GUI 版本调试 BokehJS。请参阅使用开发者工具服务器进行测试，了解有关使用 Chrome 的 GUI 版本调试 BokehJS 的说明。

如果您需要直接在 Chrome 的无头版本中进行调试，请按照以下步骤操作

  1. 使用 node test/devtools server 启动 BokehJS 开发者工具服务器。

  2. 打开另一个控制台并运行 node make test:run:headless。这将以无头模式启动 Chrome，并预先配置为 BokehJS 测试设置。

  3. 打开 Chrome 或 Chromium 浏览器并输入 URL https://127.0.0.1:9222

  4. 单击页面底部的 about:blank 链接。您可以忽略该页面的其余部分。

  5. 单击此链接将打开一个远程开发者工具控制台。使用此控制台内的导航栏来使用端点，您通常会在浏览器 GUI 版本的 Bokeh 开发者工具服务器中使用这些端点。

Screenshot of a Chromium web browser displaying controls for Bokeh's preconfigured version of headless Chrome.

请参阅使用开发者工具服务器进行测试，以获取有关 Bokeh 开发者工具服务器的更多信息。