ソースマッピング
エラーのトラブルシューティングを行うときは、JavaScript コードのどこでエラーが発生したかを正確に把握しておくと役立ちます。アプリケーションのソースマップとソースファイルをアップロードして、エラーの正確な場所を見つけることができます。
[Instances] タブで、エラーの発生元のスクリプトを展開すると、[Source Mapping] セクションを使用して、ソースマップとソースファイルをアップロードし、エラーをさらにトラブルシューティングできます。マップとファイルをアップロードすると、HTML スニペットにファイルのソースコードが入力され、ソースコード内のエラーが発生した場所が正確に強調表示されます。
ソースマップとソースファイルをアップロードするには、次の手順を実行します。
- エラーメッセージを展開します。
- スタックフレームをクリックします。
- [Properties] セクションで、[Source Mapping] まで下にスクロールします。
- [Upload] をクリックして、JSON ソースマップとソースファイルをアップロードします（ソースマップとソースファイルの許可される最大サイズは 10 MB です）。
ソースマッピングのヒントと推奨事項
アップロードするソースマップとソースファイルについて、いくつかのオプションがあります。次の操作を実行できます。
- ソースマップファイルのみをアップロードします（ソースマップファイルにソースファイルも含まれている場合）。
- 最初にソースマップファイルをアップロードしてから、ソースファイルをアップロードします。
-
（ソースマップファイルなしで）ソースファイルのみをアップロードします。
ソースファイルをアップロードした後にソースマップファイルをアップロードすると、アップロードされたソースファイルは自動的に削除されます。
1 つ以上のソースファイルをアップロードできます。ソースマップファイルがアップロードされると、そのソースマップファイルに関連付けられているソースファイルのリストが UI に表示されます。
同じソースマップを共有するソースファイルには、異なる名前を付けることをお勧めします。ソースファイルが異なるパスにある場合でも、最初のソースファイルの名前が /path/to/myBrowserApp.js で 2 番目のソースファイルの名前が /different/path/to/myBrowserApp.js の場合、最初のソースファイル /path/to/myBrowserApp.js をアップロードし、後で 2 番目のソースファイル /different/path/to/myBrowserApp.js をアップロードすると、スタックが最初のソースファイルに関連付けられている場合は、最初のソースファイルを再度アップロードする必要があります。これは、ソースファイルがファイル名を識別子として使用して永続化されるためです。
（オプション）JavaScript エージェントにアプリケーションのリリース情報を追加する
ソースマッピング機能を使用する前に、アプリケーションにリリース名、バージョン、キーなどのアプリケーションのリリース情報を追加できます。エラーが発生すると、JavaScript エージェントはエラー情報とリリース ID を含むビーコンを送信します。エラーをトラブルシューティングするためにソースマップとソースファイルをアップロードすると、リリース ID が一致し、エラーの原因となったコードの正確な行が強調表示されます。リリース ID を構成するには、「アプリケーションリリースの詳細の追加」を参照してください。