JavaScript Array findIndex()

Definisi dan penggunaan

findIndex() Metode kembalikan indeks elemen pertama yang melalui tes di dalam array (disediakan sebagai fungsi)

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

  • Jika menemukan elemen array yang mengembalikan nilai true dari fungsi, findIndex() kembalikan indeks elemen array itu (tanpa memeriksa nilai sisanya)
  • Lainnya kembalikan -1

Keterangan:findIndex() Tidak akan melaksanakan fungsi untuk elemen array yang kosong.

Keterangan:findIndex() Tidak akan mengubah array asli.

Contoh

Contoh 1

Ambil indeks elemen pertama di dalam array yang sama atau lebih besar dari 18:

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

Coba sendiri

Contoh 2

Dapatkan indeks elemen pertama di dalam array yang nilai lebih tinggi daripada 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) {
  return age >= document.getElementById("ageToCheck").value;
}
function myFunction() {
  document.getElementById("demo").innerHTML = ages.findIndex(checkAdult);
}
</script>

Coba sendiri

Sintaksis

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

Nilai parameter

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

Parameter fungsi:

Parameter Deskripsi
currentValue Diperlukan. Nilai elemen saat ini.
index Pilihan. Indeks array elemen saat ini.
arr Pilihan. Objek array milik elemen saat ini.
thisValue

Pilihan. Nilai yang akan disampaikan ke fungsi untuk digunakan sebagai nilai "this"-nya.

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

Detil teknis

Nilai kembalian: Jika ada elemen dalam array melalui tes, kembalikan indeks elemen array, jika tidak kembalikan -1.
Versi JavaScript: ECMAScript 6

Dukungan browser

Angka di tabel menunjukkan versi browser pertama 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

Keterangan:Internet Explorer tidak mendukung findIndex() Metode.

Halaman Terkait

Tutorial:Array JavaScript

Tutorial:Const Array JavaScript

Tutorial:Metode Array JavaScript

Tutorial:Pengurutan Array JavaScript

Tutorial:Iterasi Array JavaScript