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ß-/kleinschreibungssensitive Suche durch, um festzustellen, ob ein bestimmter 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, der innerhalb von str gesucht werden soll. Darf kein Regex sein. Alle Werte, die keine Regexes sind, werden in Strings umgewandelt, sodass das Weglassen oder Übergeben von undefined dazu führt, dass includes() nach dem String "undefined" sucht, 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 Suchstring irgendwo im gegebenen String 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 zu bestimmen, ob ein String einen anderen String einschließt oder nicht.

Groß-/Kleinschreibung

Die includes()-Methode berücksichtigt die Groß-/Kleinschreibung. 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 Suchstring 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