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 Methode includes() von String-Werten führt eine Groß-/Kleinschreibung beachtende Suche durch, um festzustellen, ob eine bestimmte Zeichenfolge innerhalb dieser Zeichenfolge 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

js
includes(searchString)
includes(searchString, position)

Parameter

searchString

Eine Zeichenfolge, die in str gesucht wird. Kann kein Regex sein. Alle Werte, die keine Regexes sind, werden zu Zeichenfolgen umgewandelt, daher führt das Weglassen oder Übergeben von undefined dazu, dass includes() nach der Zeichenfolge "undefined" sucht, was selten gewünscht ist.

position Optional

Die Position innerhalb der Zeichenfolge, an der begonnen werden soll, nach searchString zu suchen. (Standard ist 0.)

Rückgabewert

true, wenn die Suchzeichenfolge irgendwo in der angegebenen Zeichenfolge gefunden wird, einschließlich der Fälle, in denen searchString eine leere Zeichenfolge ist; andernfalls false.

Ausnahmen

TypeError

Wird ausgelöst, wenn searchString ein Regex ist.

Beschreibung

Mit dieser Methode können Sie feststellen, ob eine Zeichenfolge eine andere Zeichenfolge enthält oder nicht.

Groß-/Kleinschreibung

Die Methode includes() unterscheidet zwischen Groß- und Kleinschreibung. Zum Beispiel ergibt der folgende Ausdruck false:

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

Dieses Verhalten können Sie umgehen, indem Sie sowohl die ursprüngliche Zeichenfolge als auch die Suchzeichenfolge in Kleinbuchstaben umwandeln:

js
"Blue Whale".toLowerCase().includes("blue"); // returns true

Beispiele

Verwendung von includes()

js
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

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
includes

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Uses a non-standard name.
Has more compatibility info.

Siehe auch