console: assert() statische Methode

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.

Hinweis: Diese Funktion ist in Web Workers verfügbar.

Die console.assert() statische Methode schreibt eine Fehlermeldung in die Konsole, wenn die Annahme falsch ist. Wenn die Annahme wahr ist, passiert nichts.

Syntax

js
console.assert(assertion)

console.assert(assertion, val1)
console.assert(assertion, val1, val2)
console.assert(assertion, val1, val2, /* …, */ valN)

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

Parameter

assertion

Jede boolesche Ausdruck. Wenn die Annahme falsch ist, wird eine generische Meldung, die auf einen Fehler in der Annahme hinweist, in die Konsole geschrieben.

val1 … valN

Eine Liste von JavaScript-Werten zur Ausgabe. Eine Darstellung jedes dieser Werte wird der Konsole nach einer generischen Fehlermeldung (die sich von der Meldung unterscheiden kann, die ohne diese Werte ausgegeben wird) in der angegebenen Reihenfolge mit einer Art von Trennung zwischen der Meldung und jedem dieser Werte ausgegeben. Es gibt einen Sonderfall, wenn val1 ein String ist, der im Folgenden beschrieben wird.

msg

Ein JavaScript-String, der null oder mehr Ersetzungszeichenfolgen enthält, die durch subst1 bis substN in aufeinanderfolgender Reihenfolge bis zur Anzahl der Ersetzungszeichenfolgen ersetzt werden. Ein Doppelpunkt, ein Leerzeichen und dann die ersetzte Zeichenfolge werden zu der generischen Fehlermeldung hinzugefügt, um eine detaillierte Fehlermeldung zu bilden, und das Ergebnis wird in die Konsole ausgegeben. Siehe Verwendung von String-Ersetzungen für eine Beschreibung, wie Ersetzungen funktionieren.

subst1 … substN

JavaScript-Werte, mit denen die Ersetzungszeichenfolgen innerhalb von msg ersetzt werden. Wenn es mehr Ersetzungswerte gibt als Ersetzungszeichenfolgen, werden die zusätzlichen Werte selbst nach der detaillierten Fehlermeldung auf die gleiche Weise der Konsole geschrieben, wie wenn kein Format-String vorhanden ist.

Siehe Textausgabe in die Konsole in der Dokumentation von console für weitere Details.

Rückgabewert

Keine (undefined).

Beispiele

Das folgende Codebeispiel zeigt die Verwendung eines JavaScript-Objekts nach der Annahme:

js
const errorMsg = "the # is not even";
for (let number = 2; number <= 5; number++) {
  console.log(`the # is ${number}`);
  console.assert(number % 2 === 0, "%o", { number, errorMsg });
}
// output:
// the # is 2
// the # is 3
// Assertion failed: {number: 3, errorMsg: "the # is not even"}
// the # is 4
// the # is 5
// Assertion failed: {number: 5, errorMsg: "the # is not even"}

Spezifikationen

Specification
Console Standard
# assert

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch