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 Aussage falsch ist. Wenn die Aussage 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 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 bis substN 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:

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