← 返回首页
String.prototype.includes() - JavaScript | MDN
HTML

HTML: Markup language

HTML reference HTML guides Markup languages
CSS

CSS: Styling language

CSS reference CSS guides Layout cookbook
JavaScriptJS

JavaScript: Scripting language

JS reference JS guides
Web APIs

Web APIs: Programming interfaces

Web API reference Web API guides
All

All web technology

Technologies Topics
Learn

Learn web development

Frontend developer course Learn HTML Learn CSS Learn JavaScript
Tools

Discover our tools

About

Get to know MDN better

Blog
Seitenleiste umschalten
  1. Web
  2. JavaScript
  3. JavaScript-Referenz
  4. Eingebaute Standardobjekte
  5. String
  6. includes()
Farbschema
  • Systemeinstellung
  • Hell
  • Dunkel
Deutsch
Sprache merken Mehr erfahren

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

String.prototype.includes()

Baseline Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit September 2015 browserübergreifend verfügbar.

Die includes()-Methode von String-Werten führt eine Groß-/Kleinschreibung beachtende Suche durch, um festzustellen, ob ein gegebener String innerhalb dieses Strings gefunden werden kann und gibt entsprechend true oder false zurück.

In diesem Artikel

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

Ein String, nach dem innerhalb von str gesucht wird. Kann kein Regex sein. Alle Werte, die keine Regexes sind, werden in Strings umgewandelt. Wenn searchString weggelassen wird oder undefined übergeben wird, sucht includes() nach dem String "undefined", 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 Such-String 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 erlaubt Ihnen festzustellen, ob ein String einen anderen String enthält.

Groß-/Kleinschreibung

Die includes()-Methode ist groß-/kleinschreibungssensitiv. Zum Beispiel gibt der folgende Ausdruck false zurück:

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

Sie können diese Einschränkung umgehen, indem Sie sowohl den ursprünglichen String als auch den Such-String 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

Spezifikation
ECMAScript® 2027 Language Specification
# sec-string.prototype.includes

Browser-Kompatibilität

JavaScript aktivieren, um diese Browser-Kompatibilitätstabelle anzuzeigen.

Siehe auch

Help improve MDN

War diese Übersetzung hilfreich?
Ja Nein
Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.
Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden
  1. Eingebaute Standardobjekte
  2. String
  3. Konstruktor
    1. String()
  4. Statische Methoden
    1. fromCharCode()
    2. fromCodePoint()
    3. raw()
  5. Instanzmethoden
    1. anchor()
    2. at()
    3. big()
    4. blink()
    5. bold()
    6. charAt()
    7. charCodeAt()
    8. codePointAt()
    9. concat()
    10. endsWith()
    11. fixed()
    12. fontcolor()
    13. fontsize()
    14. includes()
    15. indexOf()
    16. isWellFormed()
    17. italics()
    18. lastIndexOf()
    19. link()
    20. localeCompare()
    21. match()
    22. matchAll()
    23. normalize()
    24. padEnd()
    25. padStart()
    26. repeat()
    27. replace()
    28. replaceAll()
    29. search()
    30. slice()
    31. small()
    32. split()
    33. startsWith()
    34. strike()
    35. sub()
    36. substr()
    37. substring()
    38. sup()
    39. toLocaleLowerCase()
    40. toLocaleUpperCase()
    41. toLowerCase()
    42. toString()
    43. toUpperCase()
    44. toWellFormed()
    45. trim()
    46. trimEnd()
    47. trimStart()
    48. valueOf()
    49. [Symbol.iterator]()
  6. Instanzeigenschaften
    1. length
  7. Vererbung
  8. Object/Function
  9. Statische Methoden
    1. apply()
    2. bind()
    3. call()
    4. toString()
    5. [Symbol.hasInstance]()
  10. Statische Eigenschaften
    1. displayName
    2. length
    3. name
    4. prototype
    5. arguments
    6. caller
  11. Instanzmethoden
    1. __defineGetter__()
    2. __defineSetter__()
    3. __lookupGetter__()
    4. __lookupSetter__()
    5. hasOwnProperty()
    6. isPrototypeOf()
    7. propertyIsEnumerable()
    8. toLocaleString()
    9. toString()
    10. valueOf()
  12. Instanzeigenschaften
    1. __proto__
    2. constructor

Der Bauplan für ein besseres Internet.

MDN Mitmachen Entwicklung

Besuche die gemeinnützige Muttergesellschaft der Mozilla Corporation, die Mozilla Foundation.
Teile dieses Inhalts sind ©1998–2026 von einzelnen mozilla.org-Mitwirkenden. Inhalte sind verfügbar unter einer Creative-Commons-Lizenz.