偵錯

使用 @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 Server 以及從 Blocklet Server 接收的資料非常有幫助。

在瀏覽器中

若要在網頁瀏覽器中啟用偵錯，您可以使用開發者工具控制台來設定一個 localStorage 項目。

Browser Console

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

執行命令後，重新整理頁面。現在您將在控制台中看到來自 @blocklet/server-js 客戶端的詳細偵錯訊息。這有助於您直接在瀏覽器環境中檢查 API 呼叫和回應。

若要停用日誌，您可以清除 debug 項目或將其設定為空值：

Browser Console

localStorage.removeItem('debug')

使用這些偵錯工具可以顯著加快識別和修復應用程式中問題的過程。