JavaScript Array find()

Definisi dan penggunaan

find() Metode ini mengembalikan nilai elemen pertama yang melampaui tes (diberikan sebagai fungsi)

find() Metode ini melaksanakan fungsi sekali untuk setiap elemen yang ada di dalam array:

  • Jika menemukan elemen array yang nilai fungsi kembalikan true, find() kembalikan nilai elemen array itu (tanpa memeriksa nilai yang tersisa)
  • Jika tidak, kembalikan undefined

Catatan:find() Jangan lakukan fungsi ini terhadap array kosong.

Catatan:find() Tidak akan mengubah array asli.

Contoh

Contoh 1

Ambil nilai elemen pertama di dalam array yang nilai nya 18 atau lebih besar:

var umurs = [3, 10, 18, 20];
function checkAdult(age) {
  kembalikan age >= 18;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}

Coba sendiri

Contoh 2

Dapatkan nilai elemen pertama di dalam array yang nilai nya di atas angka tertentu:

<p>Umur minimum: <input type="number" id="ageToCheck" value="18"></p>
<button onclick="myFunction()">Coba</button>
<p>Umur apapun di atas: <span id="demo"></span></p>
<script>
var ages = [4, 12, 16, 20];
function checkAdult(age) {
  kembalikan age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.find(checkAdult);
}
</script>

Coba sendiri

Sintaks

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

nilai parameter

Parameter Deskripsi
function(currentValue, index, arr) Wajib. Fungsi yang dijalankan untuk setiap elemen dalam array.

Parameter fungsi:

Parameter Deskripsi
currentValue Wajib. Nilai elemen saat ini.
index Pilihan. Indeks array elemen saat ini.
arr Pilihan. Objek array yang dimiliki elemen saat ini.
thisValue

Pilihan. Nilai yang akan disampaikan ke fungsi untuk digunakan sebagai nilai 'this'.

Jika parameter ini kosong, nilai 'undefined' akan disampaikan sebagai nilai 'this' nya.

Detil teknis

Nilai kembalian: Jika elemen mana pun di dalam array melalui tes, kembalikan nilai elemen array, jika tidak kembalikan undefined.
Versi JavaScript: ECMAScript 6

Dukungan peramban

Angka di tabel menunjukkan versi pertama penggunaan peramban yang mendukung metode ini penuh.

Chrome Edge Firefox Safari Opera
Chrome 45 Edge 12 Firefox 25 Safari 7.1 Opera 32
September 2015 Juli 2015 Juli 2014 September 2014 September 2015

Catatan:Internet Explorer tidak mendukung find() Metode.

Halaman-Relasi

Panduan:Array JavaScript

Panduan:Const Array JavaScript

Panduan:Metode Array JavaScript

Panduan:Pengurutan Array JavaScript

Panduan:Iterasi Array JavaScript