调试

在使用 @blocklet/server-js 构建应用程序时，您可能会遇到 API 请求、身份验证或数据获取方面的问题。为了帮助您排查这些问题，客户端提供了详细的调试日志。这使您可以检查发送的原始 GraphQL 查询、接收的响应以及其他内部操作。

该库使用了流行的 debug 实用工具，它支持命名空间日志记录。您可以在 Node.js 和浏览器环境中启用这些日志。

在 Node.js 中

在 Node.js 环境中，您可以在运行应用程序时通过设置 DEBUG 环境变量来启用调试日志。@blocklet/server-js 客户端使用 sdk:* 命名空间。

要查看来自客户端的所有调试输出，请像这样运行您的脚本：

Terminal

DEBUG="sdk:*" node your-app.js

此命令会将详细信息打印到您的控制台，包括 GraphQL 查询、变量以及每个操作的结果。这对于准确了解正在发送到 Blocklet 服务器以及从 Blocklet 服务器接收的数据非常有用。

在浏览器中

要在 Web 浏览器中启用调试，您可以使用开发者工具控制台设置一个 localStorage 项。

Browser Console

localStorage.setItem('debug', 'sdk:*')

运行该命令后，刷新页面。您现在将在控制台中看到来自 @blocklet/server-js 客户端的详细调试消息。这有助于您直接在浏览器上下文中检查 API 调用和响应。

要禁用日志，您可以清除 debug 项或将其设置为空值：

Browser Console

localStorage.removeItem('debug')

使用这些调试工具可以显著加快识别和修复应用程序中问题的过程。