String.prototype.includes()

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 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 gewnscht ist.

position Optional

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

Rckgabewert

true, wenn der Such-String irgendwo innerhalb des gegebenen Strings gefunden wird, einschlielich wenn searchString ein leerer String ist; andernfalls false.

Ausnahmen

TypeError

Wird ausgelst, wenn searchString ein Regex ist.

Beschreibung

Diese Methode erlaubt Ihnen festzustellen, ob ein String einen anderen String enthlt.

Gro-/Kleinschreibung

Die includes()-Methode ist gro-/kleinschreibungssensitiv. Zum Beispiel gibt der folgende Ausdruck false zurck:

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

Sie knnen diese Einschrnkung umgehen, indem Sie sowohl den ursprnglichen 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")); // 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

Browser-Kompatibilitt

Siehe auch

• Polyfill von String.prototype.includes in core-js
• es-shims Polyfill von String.prototype.includes
• Array.prototype.includes()
• TypedArray.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()
• String.prototype.startsWith()
• String.prototype.endsWith()