JavaScript Array findLastIndex()

Example 1

Find the last element with a value over 18:

const ages = [3, 10, 18, 20];

ages.findLastIndex(checkAge);

function checkAge(age) {
  return age > 18;
}
Try it Yourself »

Description

The findLastIndex() method executes a function for each array element.

The findLastIndex() method returns the index (position) of the last element that passes a test.

The findLastIndex() method returns -1 if no match is found.

The findLastIndex() method does not execute the function for empty array elements.

The findLastIndex() method does not change the original array.


Array Find Methods:

MethodFinds
indexOf()The value of the first element with a specified value
lastIndexOf()The index of the last element with a specified value
find()The value of the first element that passes a test
findIndex()The index of the first element that passes a test
findLast()The value of the last element that passes a test
findLastIndex()The index of the last element that passes a test

Syntax

array.findLastIndex(function(currentValue, index, arr), thisValue)

Parameters

Parameter Description
function() Required.
A function to be run for each array element.
currentValue Required.
The value of the current element.
index Optional.
The index of the current element.
arr Optional.
The array of the current element.
thisValue Optional. Default undefined.
A value passed to the function as its this value.

Return Value

Type Description
Number The index of the last element that passes the test.
Otherwise -1.


More Examples

Find the last element with a value above an input value:

<p><input type="number" id="toCheck" value="18"></p>

<button onclick="myFunction()">Test</button>

<p>Any values above: <span id="demo"></span></p>

<script>
const numbers = [4, 12, 16, 20];

function checkValue(x) {
  return x > document.getElementById("toCheck").value;
}

function myFunction() {
  document.getElementById("demo").innerHTML = numbers.findLastIndex(checkValue);
}
</script>
Try it Yourself »

Browser Support

findLastIndex() is an ES2023 feature.

It is supported in all modern browsers since July 2023:

Chrome 110 Edge 110 Firefox 115 Safari 16.4 Opera 96
Feb 2023 Feb 2023 Jul 2023 Mar 2023 May 2023

Copyright 1999-2023 by Refsnes Data. All Rights Reserved.