Dieincludes()-Methode vonString-Werten führt eine Groß-/Kleinschreibung beachtende Suche durch, um festzustellen, ob ein gegebener String innerhalb dieses Strings gefunden werden kann und gibt entsprechendtrue oderfalse 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

Ein String, nach dem innerhalb vonstr gesucht wird. Kannkein Regex sein. Alle Werte, die keine Regexes sind, werdenin Strings umgewandelt. WennsearchString weggelassen wird oderundefined übergeben wird, suchtincludes() nach dem String"undefined", was selten gewünscht ist.

positionOptional

Die Position innerhalb des Strings, an der die Suche nachsearchString beginnen soll. (Standard ist0.)

Rückgabewert

true, wenn der Such-String irgendwo innerhalb des gegebenen Strings gefunden wird, einschließlich wennsearchString ein leerer String ist; andernfallsfalse.

Ausnahmen

TypeError

Wird ausgelöst, wennsearchStringein Regex ist.

Beschreibung

Diese Methode erlaubt Ihnen festzustellen, ob ein String einen anderen String enthält.

Groß-/Kleinschreibung

Dieincludes()-Methode ist groß-/kleinschreibungssensitiv. Zum Beispiel gibt der folgende Ausdruckfalse 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

Beispiele

Verwendung von includes()

const str = "To be, or not to be, that is the question.";console.log(str.includes("To be")); // trueconsole.log(str.includes("question")); // trueconsole.log(str.includes("nonexistent")); // falseconsole.log(str.includes("To be", 1)); // falseconsole.log(str.includes("TO BE")); // falseconsole.log(str.includes("")); // true

Spezifikationen

Browser-Kompatibilität

Siehe auch

• Polyfill vonString.prototype.includes incore-js
• es-shims Polyfill vonString.prototype.includes
• Array.prototype.includes()
• TypedArray.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()
• String.prototype.startsWith()
• String.prototype.endsWith()