Window: reportError() メソッド

reportError() はWindow インターフェイスのメソッドで、 JavaScript の捕捉されない例外をエミュレートして、コンソールやグローバルイベントハンドラーにエラーを報告するために使用することができます。

この機能は、主にカスタムイベント配信ライブラリーやコールバック操作ライブラリーを対象としています。ライブラリーはこの機能を使用して、コールバックコードのエラーを捕捉し、最上位のハンドラーに投げ直すことができます。これにより、 1 つのコールバックで例外が発生しても、他のコールバックが処理されなくなることがなくなると同時に、スタックトレース情報が最上位レベルのデバッグに利用できるようになります。

構文

reportError(throwable)

引数

throwable: エラーオブジェクト、例えばTypeError です。

返値

なし (undefined)。

例外

TypeError: エラー引数なしでこのメソッドが呼び出された場合。

例

このメソッドが使用できるかどうかの機能検出です。

if (typeof window.reportError === "function") {  // この関数が定義されている}

以下のコードでは、どのようにエラーを作成して報告する方法、グローバルなonerror ハンドラーを使用するか、error イベントのリスナーを追加してエラーを捕捉する方法を示しています。onerror に割り当てられたハンドラーは、true を返さなければ、イベントがそれ以上伝播しないことに注意してください。

const newError = new Error("エラーメッセージ", "someFile.js", 11);window.reportError(newError);window.onerror = (message, source, lineno, colno, error) => {  console.error(`メッセージ: ${error.message}、行番号: ${lineno}`);  return true;};window.addEventListener("error", (error) => {  console.error(error.filename);});// 出力// > "メッセージ: エラーメッセージ、行番号: 11"// > "someFile.js"