String.prototype.includes()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

Die includes()-Methode von String-Werten führt eine groß-/kleinschreibungssensitive Suche durch, um festzustellen, ob eine gegebene Zeichenfolge innerhalb dieser Zeichenfolge gefunden werden kann, und gibt entsprechend true oder false zurück.

Probieren Sie es aus

Syntax

js
includes(searchString)
includes(searchString, position)

Parameter

searchString

Eine Zeichenfolge, nach der innerhalb von str gesucht werden soll. Kann kein regulärer Ausdruck sein. Alle Werte, die keine regulären Ausdrücke sind, werden in Zeichenfolgen umgewandelt, daher führt das Weglassen oder Übergeben von undefined dazu, dass includes() nach der Zeichenfolge "undefined" sucht, was selten gewünscht ist.

position Optional

Die Position innerhalb der Zeichenfolge, an der die Suche nach searchString beginnen soll. (Standard ist 0.)

Rückgabewert

true, wenn die gesuchte Zeichenfolge irgendwo innerhalb der gegebenen Zeichenfolge gefunden wird, einschließlich wenn searchString eine leere Zeichenfolge ist; andernfalls false.

Ausnahmen

TypeError

Wird ausgelöst, wenn searchString ein regulärer Ausdruck ist.

Beschreibung

Diese Methode ermöglicht es Ihnen festzustellen, ob eine Zeichenfolge eine andere Zeichenfolge enthält.

Groß-/Kleinschreibungssensitivität

Die includes()-Methode unterscheidet nach Groß- und Kleinschreibung. Zum Beispiel gibt der folgende Ausdruck false zurück:

js
"Blue Whale".includes("blue"); // returns false

Sie können dieses Problem umgehen, indem Sie sowohl die ursprüngliche Zeichenfolge als auch die gesuchte Zeichenfolge in Kleinbuchstaben umwandeln:

js
"Blue Whale".toLowerCase().includes("blue"); // returns true

Beispiele

Verwendung von includes()

js
const str = "To be, or not to be, that is the question.";

console.log(str.includes("To be")); // true
console.log(str.includes("question")); // true
console.log(str.includes("nonexistent")); // false
console.log(str.includes("To be", 1)); // false
console.log(str.includes("TO BE")); // false
console.log(str.includes("")); // true

Spezifikationen

Specification
ECMAScript Language Specification
# sec-string.prototype.includes

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch