console : méthode statique assert()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

La méthode console.assert() permet d'écrire un message d'erreur dans la console si l'assertion passée en argument est fausse. Si l'assertion est bien vérifiée, rien ne se passe.

Note: Cette fonctionnalité est disponible via les Web Workers.

Syntaxe

js
assert(assertion, obj1)
assert(assertion, obj1, obj2)
assert(assertion, obj1, obj2, /* …, */ objN)

assert(assertion, msg)
assert(assertion, msg, subst1)
assert(assertion, msg, subst1, /* …, */ substN)

Paramètres

assertion

Une expression booléenne. Si l'assertion est fausse, le message est affiché dans la console.

obj1objN

Une liste d'objets JavaScript à afficher. Les représentations en chaînes de caractères de ces objets sont concaténés dans l'ordre et affichés dans la console.

msg

Une chaîne de caractères JavaScript qui contient zéro ou plusieurs chaînes de substitution.

subst1substN

Des objets JavaScript avec lesquels remplacer les chaînes de substitution dans msg. Ce paramètre permet un contrôle supplémentaire sur le format de ce qui est affiché.

Valeur de retour

Aucune (undefined).

Exemples

Dans l'exemple suivant, on illustre comment utiliser un objet comme deuxième argument :

js
const messageErreur = "le nombre n'est pas pair";
for (let nombre = 2; nombre <= 5; nombre++) {
  console.log(`le nombre est ${nombre}`);
  console.assert(nombre % 2 === 0, "%o", { nombre, messageErreur });
}
// Ce qui est affiché dans la console :
// le nombre est 2
// le nombre est 3
// Assertion failed: {nombre: 3, messageErreur: "le nombre n'est pas pair"}
// le nombre est 4
// le nombre est 5
// Assertion failed: {nombre: 5, messageErreur: "le nombre n'est pas pair"}

Voir la page sur les chaînes de caractères de substitution avec console pour plus de détails.

Spécifications

Specification
Console Standard
# assert

Compatibilité des navigateurs

BCD tables only load in the browser