HTML: Markup language
CSS: Styling language
JavaScript: Scripting language
Web APIs: Programming interfaces
All web technology
Learn web development
Discover our tools
Get to know MDN better
Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.
View in English Always switch to English
Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2015 browserübergreifend verfügbar.
Die includes()-Methode von String-Werten führt eine Groß-/Kleinschreibung beachtende Suche durch, um festzustellen, ob ein gegebener String innerhalb dieses Strings gefunden werden kann und gibt entsprechend true oder false zurück.
includes()
String
true
false
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"
includes(searchString) includes(searchString, position)
searchString
Ein String, nach dem innerhalb von str gesucht wird. Kann kein Regex sein. Alle Werte, die keine Regexes sind, werden in Strings umgewandelt. Wenn searchString weggelassen wird oder undefined übergeben wird, sucht includes() nach dem String "undefined", was selten gewünscht ist.
str
undefined
"undefined"
position
Die Position innerhalb des Strings, an der die Suche nach searchString beginnen soll. (Standard ist 0.)
0
true, wenn der Such-String irgendwo innerhalb des gegebenen Strings gefunden wird, einschließlich wenn searchString ein leerer String ist; andernfalls false.
TypeError
Wird ausgelöst, wenn searchString ein Regex ist.
Diese Methode erlaubt Ihnen festzustellen, ob ein String einen anderen String enthält.
Die includes()-Methode ist groß-/kleinschreibungssensitiv. Zum Beispiel gibt der folgende Ausdruck false zurück:
"Blue Whale".includes("blue"); // returns false
Sie können diese Einschränkung umgehen, indem Sie sowohl den ursprünglichen String als auch den Such-String in Kleinbuchstaben umwandeln:
"Blue Whale".toLowerCase().includes("blue"); // returns true
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
JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.
String.prototype.includes
core-js
Array.prototype.includes()
TypedArray.prototype.includes()
String.prototype.indexOf()
String.prototype.lastIndexOf()
String.prototype.startsWith()
String.prototype.endsWith()