此頁面由社群從英文翻譯而來。了解更多並加入 MDN Web Docs 社群。
Array.prototype.find()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since 2015年9月.
Array 實例的find() 方法會回傳在提供的陣列中第一個通過所提供測試函式的元素。如果沒有任何值通過測試函式，則回傳undefined。
- 如果你需要取得該元素在陣列中的索引，請使用
findIndex()。 - 如果你需要找出某個特定值的索引，請使用
indexOf()。（這與findIndex()類似，但它是透過值的相等性來檢查每個元素，而非使用測試函式。） - 如果你想知道某個值是否存在於陣列中，請使用
includes()。它同樣是透過值的相等性來檢查每個元素，而非使用測試函式。 - 如果你想知道陣列中是否有任一元素通過所提供的測試函式，請使用
some()。 - 如果你想取得所有通過測試函式的元素，請使用
filter()。
嘗試一下
const array1 = [5, 12, 8, 130, 44];const found = array1.find((element) => element > 10);console.log(found);// 預期輸出：12語法
find(callbackFn)find(callbackFn, thisArg)參數
callbackFn會對陣列中的每個元素執行的函式。此函式應回傳真值以指出找到符合條件的元素，否則應回傳假值。此函式被呼叫時可以傳入以下引數：
thisArg選擇性執行
callbackFn時用作this的值。請參見迭代方法。
回傳值
回傳第一個通過測試函式的陣列元素。否則回傳undefined。
描述
find() 方法是一個迭代方法。它會以索引遞增順序對陣列中的每個元素執行一次所提供的callbackFn 函式，直到callbackFn 回傳一個真值。此時，find() 會回傳該元素並停止迭代陣列。若callbackFn 未曾回傳真值，則find() 會回傳undefined。請參閱迭代方法部分以深入了解這些方法的運作方式。
callbackFn 會針對陣列中每個索引執行一次，不僅限於已被賦值的索引。稀疏陣列中的空槽會視為undefined，行為將會相同。
find() 方法是通用的。它只要求this 具有length 屬性以及整數鍵屬性即可。
範例
依物件屬性找出陣列中的某個物件
const inventory = [ { name: "apples", quantity: 2 }, { name: "bananas", quantity: 0 }, { name: "cherries", quantity: 5 },];function isCherries(fruit) { return fruit.name === "cherries";}console.log(inventory.find(isCherries));// { name: 'cherries', quantity: 5 }使用箭頭函式與解構語法
const inventory = [ { name: "apples", quantity: 2 }, { name: "bananas", quantity: 0 }, { name: "cherries", quantity: 5 },];const result = inventory.find(({ name }) => name === "cherries");console.log(result); // { name: 'cherries', quantity: 5 }找出陣列中的第一個質數
下例會回傳陣列中第一個質數元素，若找不到質數則回傳undefined。
function isPrime(element, index, array) { let start = 2; while (start <= Math.sqrt(element)) { if (element % start++ < 1) { return false; } } return element > 1;}console.log([4, 6, 8, 12].find(isPrime)); // undefined，未找到console.log([4, 5, 8, 12].find(isPrime)); // 5使用 callbackFn 的第三個引數
array 引數在你沒有另外的變數參照陣列時特別有用，能讓你存取陣列中其他的元素。以下例子中，我們先用filter() 取出所有正數，再用find() 找出第一個比其相鄰數值都小的數字。
const numbers = [3, -1, 1, 4, 1, 5, 9, 2, 6];const firstTrough = numbers .filter((num) => num > 0) .find((num, idx, arr) => { // 若沒有 arr 引數，就無法存取這個中介陣列，除非先儲存成變數。 if (idx > 0 && num >= arr[idx - 1]) return false; if (idx < arr.length - 1 && num >= arr[idx + 1]) return false; return true; });console.log(firstTrough); // 1在稀疏陣列中使用 find()
稀疏陣列中的空槽仍會被訪問，並被視為與undefined 相同。
// 宣告在索引 2、3、4 處無元素的陣列const array = [0, 1, , , , 5, 6];// 顯示所有索引，包括未賦值的array.find((value, index) => { console.log("訪問索引", index, "，值為", value); return false;});// 訪問索引 0 ，值為 0// 訪問索引 1 ，值為 1// 訪問索引 2 ，值為 undefined// 訪問索引 3 ，值為 undefined// 訪問索引 4 ，值為 undefined// 訪問索引 5 ，值為 5// 訪問索引 6 ，值為 6// 顯示所有索引，包括被刪除的元素array.find((value, index) => { // 在第一次迭代時刪除元素 5 if (index === 0) { console.log("刪除 array[5]，值為", array[5]); delete array[5]; } // 即使已刪除，索引 5 仍會被訪問 console.log("訪問索引", index, "，值為", value); return false;});// 刪除 array[5]，值為 5// 訪問索引 0 ，值為 0// 訪問索引 1 ，值為 1// 訪問索引 2 ，值為 undefined// 訪問索引 3 ，值為 undefined// 訪問索引 4 ，值為 undefined// 訪問索引 5 ，值為 undefined// 訪問索引 6 ，值為 6對非陣列物件呼叫 find()
find() 方法會讀取this 的length 屬性，然後依據非負整數索引存取對應屬性。
const arrayLike = { length: 3, "-1": 0.1, // 因為 -1 < 0，find() 會忽略 0: 2, 1: 7.3, 2: 4,};console.log(Array.prototype.find.call(arrayLike, (x) => !Number.isInteger(x)));// 7.3規範
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-array.prototype.find |