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ß- und kleinschreibungssensitive Suche durch, um festzustellen, ob ein gegebener String in diesem String 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, der in str gesucht werden soll. Kann kein Regex sein. Alle Werte, die keine Regexe sind, werden in Strings umgewandelt, daher führt das Weglassen oder Übergeben von undefined dazu, dass includes() nach dem String "undefined" sucht, was selten gewünscht ist.
position Optional: Die Position innerhalb des Strings, ab der nach searchString gesucht werden soll. (Standard ist 0.)

Rückgabewert

true wenn der Suchstring 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 ermöglicht es Ihnen festzustellen, ob ein String einen anderen String einschließt.

Groß- und Kleinschreibung

Die includes()-Methode berücksichtigt die Groß- und Kleinschreibung. Zum Beispiel liefert der folgende Ausdruck false zurück:

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

Sie können dieses Problem umgehen, indem Sie sowohl den ursprünglichen String als auch den Suchstring in Kleinschreibung 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