The includes()
method of String
values performs a case-sensitive search to determine whether a given string may be found within this string, returning true
or false
as appropriate.
On this page
String.prototype.includes()
Try it
Syntax
includes(searchString)
includes(searchString, position)
Parameters
-
searchString
-
A string to be searched for within
str
. Cannot be a regex. All values that are not regexes are coerced to strings, so omitting it or passingundefined
causesincludes()
to search for the string"undefined"
, which is rarely what you want. position
Optional-
The position within the string at which to begin searching for
searchString
. (Defaults to0
.)
Return value
true
if the search string is found anywhere within the given string, including when searchString
is an empty string; otherwise, false
.
Exceptions
-
TypeError
-
Thrown if
searchString
is a regex.
Description
This method lets you determine whether or not a string includes another string.
Case-sensitivity
The includes()
method is case sensitive. For example, the following expression returns false
:
"Blue Whale".includes("blue"); // returns false
You can work around this constraint by transforming both the original string and the search string to all lowercase:
"Blue Whale".toLowerCase().includes("blue"); // returns true
Examples
Using 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
Specifications
Browser compatibility
Desktop | Mobile | Server | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
Chrome | Edge | Firefox | Opera | Safari | Chrome Android | Firefox for Android | Opera Android | Safari on IOS | Samsung Internet | WebView Android | Deno | Node.js | ||
includes |
41 | 12 | 4018–48 | 28 | 9 | 41 | 4018–48 | 28 | 9 | 4.0 | 41 | 1.0 | 4.0.0 |
See also
© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/includes