String.prototype.includes()

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

Die Zeichenfolge, nach der in str gesucht wird. Sie darf kein regulärer Ausdruck sein. Alle Werte, die keine regulären Ausdrücke sind, werden in Zeichenfolgen umgewandelt. Wenn Sie den Parameter weglassen oder undefined übergeben, sucht includes() daher nach der Zeichenfolge "undefined", was selten beabsichtigt ist.

position Optional

Die Position innerhalb der Zeichenfolge, ab der nach searchString gesucht wird. (Standardwert: 0.)

Rückgabewert

true, wenn die gesuchte Zeichenfolge an irgendeiner Stelle in der angegebenen Zeichenfolge gefunden wird, auch wenn searchString eine leere Zeichenfolge ist; andernfalls false.

Ausnahmen

TypeError

Wird ausgelöst, wenn searchString ein regulärer Ausdruck ist.

Beschreibung

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

Groß- und Kleinschreibung

Die Methode includes() unterscheidet zwischen Groß- und Kleinschreibung. Der folgende Ausdruck gibt beispielsweise false zurück:

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

Sie können diese Einschränkung umgehen, indem Sie sowohl die ursprüngliche Zeichenfolge als auch die gesuchte Zeichenfolge in Kleinbuchstaben umwandeln:

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

Beispiele

includes() verwenden

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

Browser-Kompatibilität

Siehe auch

• Polyfill für String.prototype.includes in core-js
• Polyfill für String.prototype.includes von es-shims
• Array.prototype.includes()
• TypedArray.prototype.includes()
• String.prototype.indexOf()
• String.prototype.lastIndexOf()
• String.prototype.startsWith()
• String.prototype.endsWith()