JSSアプリでのデバッグ ロギング
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore JSS NPMパッケージとサンプルは、デバッグ情報を出力するために デバッグモジュール を使用します。
このモジュールは、console.log() ステートメントの拡張バージョンであるdebug() 関数を公開します。console.logとは異なり、本番コードでdebug() 呼び出しをコメントアウトしたり削除したりする必要がないため、必要に応じて環境変数を使用して本番環境でデバッグログを簡単に有効にできます。
すべてのSitecore JSSログは、ルートネームスペースsitecore-jssの下に整理されています。ログ記録はデフォルトでオフになっており、DEBUG環境変数を使用して条件付きでオンにすることができます。
デバッグログにはサーバー側のコードのみが含まれるため、ブラウザでデバッグログを有効にする利点はありません。
使用可能なすべてのデバッグログを出力するには、DEBUG環境変数をsitecore-jss:*に設定します。アスタリスク (*) はワイルドカードとして使用されます。
DEBUG=sitecore-jss:*選択的に選択して、特定のカテゴリのログメッセージ (レイアウトサービスログなど) のみを表示することができます。
DEBUG=sitecore-jss:layoutまたは、- プレフィックスを使用して、レイアウトサービスログを除くすべてのログを表示することもできます。
DEBUG=sitecore-jss:*,-sitecore-jss:layout名前空間
次の表に、使用可能なすべての名前空間と、該当するSitecore JSS npmパッケージおよびサンプル アプリケーションを示します。
|
Namespace |
パッケージ / サンプルアプリ |
形容 |
|---|---|---|
|
sitecore-jss:http |
sitecore-jss,nextjs |
デフォルトのフェッチラッパー(GraphQLRequestClient、NativeDataFetcher(JSS version >= 22.4)、およびAxiosDataFetcher(JSS version <= 22.3))のHTTPリクエストとレスポンスのログ記録。 |
|
sitecore-jss:dictionary |
sitecore-jss、nextjs、 node-headless-ssr-experience-edge |
ディクショナリ サービス実装のトレース ログ記録 (GraphQLDictionaryServiceおよびRestDictionaryService)。 |
|
sitecore-jss:layout |
sitecore-jss、nextjs、node-headless-ssr-experience-edge |
レイアウト サービス実装 (GraphQLLayoutServiceとRestLayoutService) のトレース ログ。 |
|
sitecore-jss:editing |
sitecore-jss-nextjs,nextjs |
Sitecoreエディター統合のためのNext.jsミドルウェアのトレース ログ。 |
|
sitecore-jss:sitemap |
sitecore-jss-nextjs、nextjs、nextjs-sxa |
Next.js GraphQLサイトマップ サービス (GraphQLSitemapService) とヘッドレスSXA sitemap.xmlサービス (GraphQLSitemapXmlService) のトレース ログ。 |
|
sitecore-jss:robots |
sitecore-jss-nextjs、nextjs、nextjs-sxa |
Next.jsヘッドレスSXA robots.txtサービス (GraphQLRobotsService) のトレース ログ |
|
sitecore-jss:redirects |
sitecore-jss-nextjs、nextjs、nextjs-sxa |
Next.jsヘッドレスSXAのトレース ログは、ミドルウェア (RedirectsMiddlewareをリダイレクトします。 |
|
sitecore-jss:errorpages |
sitecore-jss-nextjs、nextjs、nextjs-sxa |
Next.jsヘッドレスSXAエラー ページ サービス (GraphQLErrorPagesService) のトレース ログ |
|
sitecore-jss:multisite |
sitecore-jss、sitecore-jss-nextjs、nextjs、nextjs-multisite |
GraphQLサイト情報サービス (GraphQLSiteInfoService) とNext.jsマルチサイト ミドルウェア (MultisiteMiddleware) のトレース ログ。 |
詳細オプション
Node.jsを使用して実行する場合は、次の環境変数を使用して、デバッグログの動作を変更するいくつかの追加の環境変数を設定できます。
|
名前 |
形容 |
|---|---|
|
DEBUG |
特定のデバッグ名前空間を有効/無効にします。 |
|
DEBUG_HIDE_DATE |
デバッグ出力から日付を非表示にします (非TTY)。 デフォルト： false |
|
DEBUG_COLORS |
デバッグ出力で色を使用するかどうか。 デフォルト： true |
|
DEBUG_DEPTH |
オブジェクト検査の深さ。 デフォルト: 2 |
|
DEBUG_MULTILINE |
検査対象物を複数行に整形印刷します。 デフォルト:false(1行) |
|
DEBUG_SHOW_HIDDEN |
検査対象のオブジェクトの非表示のプロパティを表示します。 デフォルト： false |