デバッグ

@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との間で送受信されるデータを正確に理解するのに非常に役立ちます。

ブラウザでの利用

ウェブブラウザでデバッグを有効にするには、開発者ツールのコンソールを使用してlocalStorage項目を設定します。

Browser Console

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

コマンドを実行した後、ページを更新してください。@blocklet/server-jsクライアントからの詳細なデバッグメッセージがコンソールに記録されるようになります。これにより、ブラウザのコンテキスト内で直接APIコールとレスポンスを検査できます。

ログを無効にするには、debug項目をクリアするか、空の値に設定します：

Browser Console

localStorage.removeItem('debug')

これらのデバッグツールを使用すると、アプリケーションの問題を特定して修正するプロセスを大幅に高速化できます。