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: Dieses Feature ist verfügbar in Web Workers.
Die console.assert()
statische Methode schreibt eine Fehlermeldung in die Konsole, wenn die Aussage falsch ist. Wenn die Aussage wahr ist, passiert nichts.
Syntax
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 Aussage falsch ist, wird eine generische Meldung, die auf den Fehler hinweist, in die Konsole geschrieben.
val1
…valN
-
Eine Liste von JavaScript-Werten zur Ausgabe. Eine Darstellung jedes dieser Werte wird nach einer generischen Fehlermeldung in die Konsole ausgegeben (die von der Meldung abweichen kann, wenn diese Werte nicht vorhanden sind) in der gegebenen Reihenfolge mit einer Art Trennung zwischen der Meldung und jedem von ihnen. Es gibt einen Sonderfall, wenn
obj1
ein String ist, der anschließend beschrieben wird. msg
-
Ein JavaScript-String, der null oder mehr Ersetzungs-Strings enthält, die in aufeinander folgender Reihenfolge mit
subst1
bissubstN
ersetzt werden, bis zur Anzahl der Ersetzungs-Strings. Ein Doppelpunkt, ein Leerzeichen und dann der ersetzte String werden angehängt, 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 Ersetzungs-Strings innerhalb von
msg
ersetzt werden. Wenn es mehr Ersetzungswerte als Ersetzungs-Strings gibt, werden die zusätzlichen Werte nach der detaillierten Fehlermeldung auf dieselbe Weise in die Konsole ausgegeben, wie wenn kein Format-String vorhanden ist.
Siehe Ausgabe von Text in die Konsole in der Dokumentation von console
für weitere Details.
Rückgabewert
Keiner (undefined
).
Beispiele
Das folgende Codebeispiel demonstriert die Verwendung eines JavaScript-Objekts nach der Aussage:
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