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 Methode includes()
von String
-Werten führt eine Groß-/Kleinschreibung beachtende Suche durch, um festzustellen, ob eine bestimmte Zeichenfolge innerhalb dieser Zeichenfolge gefunden werden kann, und gibt entsprechend true
oder false
zurück.
Probieren Sie es aus
const sentence = "The quick brown fox jumps over the lazy dog.";
const word = "fox";
console.log(
`The word "${word}" ${
sentence.includes(word) ? "is" : "is not"
} in the sentence`,
);
// Expected output: "The word "fox" is in the sentence"
Syntax
includes(searchString)
includes(searchString, position)
Parameter
searchString
-
Eine Zeichenfolge, die in
str
gesucht wird. Kann kein Regex sein. Alle Werte, die keine Regexes sind, werden zu 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 begonnen werden soll, nach
searchString
zu suchen. (Standard ist0
.)
Rückgabewert
true
, wenn die Suchzeichenfolge irgendwo in der angegebenen Zeichenfolge gefunden wird, einschließlich der Fälle, in denen searchString
eine leere Zeichenfolge ist; andernfalls false
.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn
searchString
ein Regex ist.
Beschreibung
Mit dieser Methode können Sie feststellen, ob eine Zeichenfolge eine andere Zeichenfolge enthält oder nicht.
Groß-/Kleinschreibung
Die Methode includes()
unterscheidet zwischen Groß- und Kleinschreibung. Zum Beispiel ergibt der folgende Ausdruck false
:
"Blue Whale".includes("blue"); // returns false
Dieses Verhalten können Sie umgehen, indem Sie sowohl die ursprüngliche Zeichenfolge als auch die Suchzeichenfolge 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® 2025 Language Specification # sec-string.prototype.includes |
Browser-Kompatibilität
Report problems with this compatibility data on GitHubdesktop | mobile | server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
includes |
Legend
Tip: you can click/tap on a cell for more information.
- Full support
- Full support
- Uses a non-standard name.
- Has more compatibility info.