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 statische Methode console.assert() schreibt eine Fehlermeldung in die Konsole, wenn die Behauptung falsch ist. Wenn die Behauptung 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 Behauptung falsch ist, wird eine generische Meldung, die auf das Scheitern der Behauptung hinweist, in die Konsole geschrieben.

val1valN

Eine Liste von JavaScript-Werten, die ausgegeben werden sollen. Eine Darstellung jedes dieser Werte wird nach einer generischen Fehlermeldung der Behauptung in der Konsole ausgegeben (die eventuell anders ist, wenn diese Werte nicht vorhanden sind) in der gegebenen Reihenfolge mit einer Art von Trennung zwischen der Meldung und jedem von ihnen. Es gibt einen Sonderfall, wenn val1 ein String ist, der anschließend beschrieben wird.

msg

Ein JavaScript-String, der null oder mehr Ersetzungsstrings enthält, die in aufeinanderfolgender Reihenfolge mit subst1 bis substN bis zur Anzahl der Ersetzungsstrings ersetzt werden. Ein Doppelpunkt, ein Leerzeichen und dann der ersetzte String werden der generischen Fehlermeldung der Behauptung angehängt, um eine detaillierte Behauptungsmeldung zu bilden, und das Ergebnis wird in die Konsole ausgegeben. Siehe Verwenden von String-Ersetzungen für eine Beschreibung, wie Ersetzungen funktionieren.

subst1substN

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

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

Rückgabewert

Keiner (undefined).

Beispiele

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

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
# assert

Browser-Kompatibilität

Siehe auch