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ß-/Kleinschreibung beachtende Suche durch, um festzustellen, ob ein gegebener String innerhalb dieses Strings 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: 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.
position Optional: Die Position innerhalb des Strings, an der die Suche nach searchString beginnen soll. (Standard ist 0.)

Rückgabewert

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

Ausnahmen

TypeError: Wird ausgelöst, wenn searchString ein Regex ist.

Beschreibung

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

Groß-/Kleinschreibung

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

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® 2026 Language Specification # sec-string.prototype.includes