The includes() method performs a case-sensitive search to determine whether one string may be found within another string, returning true or false as appropriate.

Try it


includes(searchString, position)



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 passing undefined causes includes() 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 to 0.)

Return value

true if the search string is found anywhere within the given string, including when searchString is an empty string; otherwise, false.



Thrown if searchString is a regex.


This method lets you determine whether or not a string includes another string.


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


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


Browser compatibility

Desktop Mobile Server
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet Deno Node.js
includes 41 12 4018–48 No 28 9 41 41 4018–48 28 9 4.0 1.0 4.0.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.