Error.isError()

利用可能性は限定的

この機能はベースラインではありません。最も広く使用されているブラウザーの一部で動作しません。

Want more support for this feature? Tell us why.

Error.isError() は静的メソッドで、渡された値が Error であるかどうかを判定します。

構文

Error.isError(value)

返値

value が Error の場合、true を返します。それ以外の場合は false を返します。

解説

Error.isError() は、渡された値が Error であるかどうかを確認します。これは、Error() コンストラクターによって初期化されたプライベートフィールドに対する「ブランドチェック」を実行することで行われます。これは Array.isArray() で使用されているのと同じ仕組みであり、さらに in 演算子で使用されている仕組みと類似しています。

これは、instanceof Error よりも堅牢な代替手段あり、誤検知や誤否認を回避することができます。

Error.isError() は、プロトタイプチェーンに Error.prototype が存在する場合でも、実際の Error インスタンスではない値を拒否します。instanceof Error はプロトタイプチェーンをチェックするため、これらの値を受け入れます。
Error.isError() は別の領域で構築された Error オブジェクトを受け入れます。この場合、instanceof Error は false を返します。これは、Error コンストラクターの同一性が領域間で異なるためです。

Error.isError() は、DOMException インスタンスに対して true を返します。これは、DOMException が Error の真のサブクラスとして指定されていないにもかかわらず（Error コンストラクタは DOMException コンストラクターのプロトタイプではない）、DOMException はすべてのブランドチェックの目的において Error と同様の振る舞いをするためです。

例

Error.isError() の使用

js
// 以下のものはすべて true を返す
Error.isError(new Error());
Error.isError(new TypeError());
Error.isError(new DOMException());
try {
  1 + 1n;
} catch (e) {
  console.log(Error.isError(e)); // この操作は TypeError を発生するので、true を返す
}

// 以下のものはすべて false を返す
Error.isError();
Error.isError({});
Error.isError(null);
Error.isError(undefined);
Error.isError(17);
Error.isError("Error");
Error.isError(true);
Error.isError(false);
// これはエラーではない。オブジェクトが Error コンストラクターによって
// 初期化されたプライベートフィールドを持たないため
Error.isError({ __proto__: Error.prototype });

instanceof と Error.isError()

Error インスタンスをチェックする際は、 Error.isError() を instanceof よりも使用することを推奨します。これは領域を超えて動作するためです。

js
const iframe = document.createElement("iframe");
document.body.appendChild(iframe);
const xError = window.frames[window.frames.length - 1].Error;
const error = new xError();

// 正しく Error をチェックした
Error.isError(error); // true
// このエラーのプロトタイプは xError.prototype であり、
// Error.prototype とは異なるオブジェクトである
error instanceof Error; // false

捕捉されたエラーの正規化

Error.isError() を使用して、捕捉された値がエラーかどうかを検出し、エラーオブジェクトに正規化できます。

js
try {
  throw "おっと、これは Error オブジェクトではありません";
} catch (e) {
  if (!Error.isError(e)) {
    e = new Error(e);
  }
  console.error(e.message);
}

仕様書

ECMAScript® 2027 Language Specification
# sec-error.iserror

ブラウザーの互換性

ブラウザー互換性一覧表を表示するには、JavaScript を有効にしてください。

MDN の改良に協力

このページは役に立ちましたか？

はいいいえ

協力方法を知る

このページは MDN の貢献者によって 2025年10月5日に最終更新されました。

GitHub でこのページを表示 • このコンテンツに関する問題を報告

標準組み込みオブジェクト
Error
コンストラクター
1. Error()
静的メソッド
1. captureStackTrace()
2. isError()
静的プロパティ
1. stackTraceLimit
インスタンスメソッド
1. toString()
インスタンスプロパティ
1. cause
2. columnNumber
3. fileName
4. lineNumber
5. message
6. name
7. stack
継承
Object/Function
静的メソッド
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
静的プロパティ
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
インスタンスメソッド
1. __defineGetter__()
2. __defineSetter__()
3. __lookupGetter__()
4. __lookupSetter__()
5. hasOwnProperty()
6. isPrototypeOf()
7. propertyIsEnumerable()
8. toLocaleString()
9. toString()
10. valueOf()
インスタンスプロパティ
1. __proto__
2. constructor
関連するページ
AggregateError
EvalError
InternalError
RangeError
ReferenceError
SyntaxError
TypeError
URIError