WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

String.prototype.includes — nach einem Teilstring suchen

String.prototype.includes prüft, ob ein Text einen angegebenen Teilstring enthält, und gibt true oder false zurück. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden; eine Startposition kann angegeben werden. Gewöhnliche reguläre Ausdrücke werden nicht akzeptiert.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

str.includes(searchString)
str.includes(searchString, position)

String.prototype.includes sucht nach einem wörtlichen Teilstring und gibt true oder false zurück, ohne den Text zu ändern. Bei der Suche wird zwischen Groß- und Kleinschreibung unterschieden, und verglichen werden UTF-16-Codeeinheiten: Unicode wird weder normalisiert noch werden sprachspezifische Vergleichsregeln angewendet.

Der optionale Parameter position gibt den frühestmöglichen Index für den Beginn eines Treffers an, gezählt ab null in UTF-16-Codeeinheiten. Standardmäßig ist der Wert 0; nach der Umwandlung in eine Zahl wird ein Nachkommaanteil gegen null abgeschnitten und das Ergebnis auf den Bereich von 0 bis zur Textlänge begrenzt. Wenn die Methode bis zum eigentlichen Vergleich gelangt, gibt sie bei leerem searchString auch dann true zurück, wenn die angegebene Position größer als die Textlänge ist. position wird jedoch vor dem Vergleich umgewandelt: Ein BigInt als position löst auch bei leerem searchString einen TypeError aus.

Ein gewöhnliches RegExp-Objekt als searchString verursacht einen TypeError; formal entscheidet der Test IsRegExp, der Symbol.match berücksichtigt. Andere Suchargumente werden in Text umgewandelt. Wird das Argument weggelassen, wird daher nach "undefined" gesucht. Wird die Methode mit null oder undefined als this aufgerufen, entsteht ein TypeError.

Dies ist eine Methode der ECMAScript-Standardbibliothek und keine Web API. Die Unterstützung in einem bestimmten Browser muss separat geprüft werden; dass die Methode in Node 24 verfügbar ist, belegt keine Browserunterstützung.

Beispiele

const text = "JavaScript";
console.log(text.includes("Script"));
console.log(text.includes("script"));
console.log(text.includes("Java", 1));
console.log(text.includes("", 99));

try {
  text.includes(/Script/);
} catch (error) {
  console.log(error.name);
}

Ergebnis

true
false
false
true
TypeError

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen