Array.find

find — Executes a provided function once per array element. If the function returns a true value, it will break the loop and return that value.

Description

Array.find(function callback, [object this])

Parameters

Return values

mixed. Returns the value of the found element or undefined if not found.

Changelog

Examples

Example #1 – find example

Run
var array = [2, 4, 8];

var result = array.find(function () {
	console.log(this);
	return true;
});

console.log(result);  // 2

Run
var arr = [2, 4, 8];

var result = arr.find(function (value, index, array) {
	console.log(value, index, array);
	return true;
});

console.log(result);  // 2

Passing in a custom object for this.

Run
var array = [2, 4, 8];

var result = array.find(function () {
	console.log(this);
	return true;
}, document.location);

console.log(result);  // 2

Emulates a failed test when the value 2 is discovered. This will make it go to the next iteration.

Run
var array = [2, 4, 4, 8];

var result = array.find(function (value) {
	if (value === 2) {
		return false;
	}
	return true;
});

console.log(result);  // 4

And if all tests fail.

Run
var array = [2, 4, 8];

var result = array.find(function (value) {
	console.log(value);
	return false;
});

console.log(result);  // undefined

External references

• Mozilla: Array.find method