Boolean() Konstruktor

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.

Der Boolean() Konstruktor erstellt Boolean Objekte. Wenn er als Funktion aufgerufen wird, gibt er primitive Werte vom Typ Boolean zurück.

Probieren Sie es aus

Syntax

js
new Boolean(value)
Boolean(value)

Note: Boolean() kann mit oder ohne new aufgerufen werden, hat jedoch unterschiedliche Effekte. Siehe Rückgabewert.

Parameter

value

Der Anfangswert des Boolean Objekts.

Rückgabewert

Wenn Boolean() als Funktion (ohne new) aufgerufen wird, gibt es value als booleanen primitiven Wert ausgelegt zurück.

Wenn Boolean() als Konstruktor (mit new) aufgerufen wird, wird value in einen booleanen primitiven Wert umgewandelt und es wird ein umschließendes Boolean Objekt zurückgegeben, das kein primitiver Wert ist.

Warnung: Sie sollten selten Boolean als Konstruktor verwenden.

Beschreibung

Der als erster Parameter übergebene Wert wird in einen booleschen Wert konvertiert. Wenn der Wert weggelassen wird oder 0, -0, 0n, null, false, NaN, undefined oder der leere String ("") ist, dann hat das Objekt einen Anfangswert von false. Alle anderen Werte, einschließlich eines beliebigen Objekts, eines leeren Arrays ([]) oder der String "false", erzeugen ein Objekt mit einem Anfangswert von true.

Hinweis: Wenn die nicht-standardmäßige Eigenschaft document.all als Argument für diesen Konstruktor verwendet wird, ist das Ergebnis ein Boolean Objekt mit dem Wert false. Diese Eigenschaft ist veraltet und nicht standardisiert und sollte nicht verwendet werden.

Beispiele

Erstellen von Boolean-Objekten mit einem Anfangswert von false

js
const bZero = new Boolean(0);
const bNull = new Boolean(null);
const bEmptyString = new Boolean("");
const bfalse = new Boolean(false);

typeof bfalse; // "object"
Boolean(bfalse); // true

Beachten Sie, dass das Konvertieren eines Boolean Objekts in einen primitiven Wert mit Boolean() immer true ergibt, selbst wenn das Objekt einen Wert von false hält. Daher wird immer davon abgeraten, Boolean Wrapper-Objekte zu erstellen.

Wenn Sie den primitiven Wert aus dem Wrapper-Objekt extrahieren möchten, verwenden Sie anstelle der Boolean() Funktion die valueOf()-Methode des Objekts.

js
const bfalse = new Boolean(false);

bfalse.valueOf(); // false

Erstellen von Boolean Objekten mit einem Anfangswert von true

js
const btrue = new Boolean(true);
const btrueString = new Boolean("true");
const bfalseString = new Boolean("false");
const bSuLin = new Boolean("Su Lin");
const bArrayProto = new Boolean([]);
const bObjProto = new Boolean({});

Spezifikationen

Specification
ECMAScript Language Specification
# sec-boolean-constructor

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch