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
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 vonundefined
dazu, dassincludes()
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 ist0
.)
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:
"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:
"Blue Whale".toLowerCase().includes("blue"); // returns true
Beispiele
Verwendung von includes()
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