Error : méthode statique isError()

Disponibilité limitée

Cette fonctionnalité n'est pas Compatible car elle ne fonctionne pas dans certains des navigateurs les plus utilisés.

La méthode statique Error.isError() détermine si la valeur passée est une erreur Error.

Dans cet article

Syntaxe

Error.isError(value)

Valeur de retour

true si value est une Error ; sinon, false.

Error.isError() vérifie si la valeur passée est une Error. Elle le fait en effectuant une vérification brandée pour un champ privé initialisé par le constructeur Error(). C'est le même mécanisme utilisé par Array.isArray(), qui est lui‑même similaire au mécanisme utilisé par l'opérateur in.

C'est une alternative plus robuste à instanceof Error car elle évite les faux positifs et les faux négatifs :

Error.isError() rejette les valeurs qui ne sont pas de véritables instances de Error, même si elles ont Error.prototype dans leur chaîne de prototypes — instanceof Error les accepterait car il vérifie la chaîne de prototypes.
Error.isError() accepte les objets Error créés dans un autre contexte d'exécution — instanceof Error renvoie false pour ces objets car l'identité du constructeur Error diffère entre les contextes d'exécution.

Error.isError() retourne true pour les instances de DOMException. Cela s'explique par le fait que, bien que DOMException ne soit pas défini comme une véritable sous‑classe d'Error (le constructeur Error n'est pas le prototype du constructeur DOMException), DOMException se comporte néanmoins comme Error pour tous les besoins de la vérification brandée.

Exemples

Utiliser la méthode Error.isError()

js
// tous les appels suivants retournent true
Error.isError(new Error());
Error.isError(new TypeError());
Error.isError(new DOMException());
try {
  1 + 1n;
} catch (e) {
  console.log(Error.isError(e)); // L'opération a levé un TypeError, donc ceci retourne true
}

// tous les appels suivants retournent false
Error.isError();
Error.isError({});
Error.isError(null);
Error.isError(undefined);
Error.isError(17);
Error.isError("Error");
Error.isError(true);
Error.isError(false);
// Ceci n'est pas une erreur, car l'objet n'a pas le champ privé
// initialisé par le constructeur Error
Error.isError({ __proto__: Error.prototype });

instanceof vs. Error.isError()

Lors de la vérification d'une instance d'Error, Error.isError() est préféré à instanceof car il fonctionne entre contextes d'exécution.

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

// Vérification correcte d'Error
Error.isError(error); // true
// Le prototype de error est xError.prototype, qui est un
// objet différent de Error.prototype
error instanceof Error; // false

Normaliser les erreurs interceptées

Vous pouvez utiliser Error.isError() pour détecter si la valeur interceptée est une erreur et la normaliser en un objet Error.

js
try {
  throw "Oups : ceci n'est pas un objet Error";
} catch (e) {
  if (!Error.isError(e)) {
    e = new Error(e);
  }
  console.error(e.message);
}

Aider à améliorer MDN

Cette page vous a-t-elle été utile ?

Oui Non

Apprendre à contribuer

Cette page a été modifiée le 27 mars 2026 par les contributeur·ice·s du MDN.

Voir cette page sur GitHub • Signaler un problème avec ce contenu

Objets natifs standards
Error
Constructeur
1. Error()
Méthodes statiques
1. captureStackTrace()
2. isError()
Propriétés statiques
1. stackTraceLimit
Méthodes d'instance
1. toString()
Propriétés d'instance
1. cause
2. columnNumber
3. fileName
4. lineNumber
5. message
6. name
7. stack
Héritage
Object/Function
Méthodes statiques
1. apply()
2. bind()
3. call()
4. toString()
5. [Symbol.hasInstance]()
Propriétés statiques
1. displayName
2. length
3. name
4. prototype
5. arguments
6. caller
Méthodes d'instance
1. Object.prototype.__defineGetter__()
2. Object.prototype.__defineSetter__()
3. Object.prototype.__lookupGetter__()
4. Object.prototype.__lookupSetter__()
5. Object.prototype.hasOwnProperty()
6. Object.prototype.isPrototypeOf()
7. Object.prototype.propertyIsEnumerable()
8. Object.prototype.toLocaleString()
9. Object.prototype.toString()
10. Object.prototype.valueOf()
Propriétés d'instance
1. Object.prototype.__proto__
2. Object.prototype.constructor
Pages similaires
AggregateError
EvalError
InternalError
RangeError
ReferenceError
SyntaxError
TypeError
URIError

Error : méthode statique isError()

Dans cet article

Syntaxe

Paramètres

Valeur de retour

Description

Exemples

Utiliser la méthode Error.isError()

instanceof vs. Error.isError()

Normaliser les erreurs interceptées

Spécifications

Compatibilité des navigateurs

Voir aussi

Aider à améliorer MDN