String.prototype.lastIndexOf()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.
The lastIndexOf()
method of String
values searches this string and returns the index of the last occurrence of the specified substring. It takes an optional starting position and returns the last occurrence of the specified substring at an index less than or equal to the specified number.
Try it
Syntax
lastIndexOf(searchString)
lastIndexOf(searchString, position)
Parameters
searchString
-
Substring to search for. All values are coerced to strings, so omitting it or passing
undefined
causeslastIndexOf()
to search for the string"undefined"
, which is rarely what you want. position
Optional-
The method returns the index of the last occurrence of the specified substring at a position less than or equal to
position
, which defaults to+Infinity
. Ifposition
is greater than the length of the calling string, the method searches the entire string. Ifposition
is less than0
, the behavior is the same as for0
— that is, the method looks for the specified substring only at index0
.-
'hello world hello'.lastIndexOf('world', 4)
returns-1
— because, while the substringworld
does occurs at index6
, that position is not less than or equal to4
. -
'hello world hello'.lastIndexOf('hello', 99)
returns12
— because the last occurrence ofhello
at a position less than or equal to99
is at position12
. -
'hello world hello'.lastIndexOf('hello', 0)
and'hello world hello'.lastIndexOf('hello', -5)
both return0
— because both cause the method to only look forhello
at index0
.
-
Return value
The index of the last occurrence of searchString
found, or -1
if not found.
Description
Strings are zero-indexed: The index of a string's first character is 0
, and the index of a string's last character is the length of the string minus 1.
"canal".lastIndexOf("a"); // returns 3
"canal".lastIndexOf("a", 2); // returns 1
"canal".lastIndexOf("a", 0); // returns -1
"canal".lastIndexOf("x"); // returns -1
"canal".lastIndexOf("c", -5); // returns 0
"canal".lastIndexOf("c", 0); // returns 0
"canal".lastIndexOf(""); // returns 5
"canal".lastIndexOf("", 2); // returns 2
Case-sensitivity
The lastIndexOf()
method is case sensitive. For example, the following
expression returns -1
:
"Blue Whale, Killer Whale".lastIndexOf("blue"); // returns -1
Examples
Using indexOf() and lastIndexOf()
The following example uses indexOf()
and
lastIndexOf()
to locate values in the string
"Brave, Brave New World"
.
const anyString = "Brave, Brave New World";
console.log(anyString.indexOf("Brave")); // 0
console.log(anyString.lastIndexOf("Brave")); // 7
Specifications
Specification |
---|
ECMAScript Language Specification # sec-string.prototype.lastindexof |
Browser compatibility
BCD tables only load in the browser