Movatterモバイル変換


[0]ホーム

URL:


  1. Web
  2. JavaScript
  3. JavaScript-Referenz
  4. Eingebaute Standardobjekte
  5. Array
  6. indexOf()

Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.

View in EnglishAlways switch to English

Array.prototype.indexOf()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Juli 2015⁩.

DieindexOf()-Methode vonArray Instanzen gibt den ersten Index zurück, an dem ein gegebenes Element im Array gefunden werden kann, oder -1, wenn es nicht vorhanden ist.

Probieren Sie es aus

const beasts = ["ant", "bison", "camel", "duck", "bison"];console.log(beasts.indexOf("bison"));// Expected output: 1// Start from index 2console.log(beasts.indexOf("bison", 2));// Expected output: 4console.log(beasts.indexOf("giraffe"));// Expected output: -1

Syntax

js
indexOf(searchElement)indexOf(searchElement, fromIndex)

Parameter

searchElement

Element, das im Array gesucht werden soll.

fromIndexOptional

Nullbasierter Index, ab dem die Suche beginnt,zu einer Ganzzahl konvertiert.

  • Ein negativer Index zählt vom Ende des Arrays zurück — wenn-array.length <= fromIndex < 0, wirdfromIndex + array.length verwendet. Beachten Sie, dass das Array in diesem Fall weiterhin von vorne nach hinten durchsucht wird.
  • WennfromIndex < -array.length oderfromIndex weggelassen wird, wird0 verwendet, wodurch das gesamte Array durchsucht wird.
  • WennfromIndex >= array.length, wird das Array nicht durchsucht und-1 wird zurückgegeben.

Rückgabewert

Der erste Index vonsearchElement im Array;-1, wenn nicht gefunden.

Beschreibung

DieindexOf()-Methode vergleichtsearchElement mit den Elementen des Arrays unter Verwendung vonstrikter Gleichheit (dem gleichen Algorithmus, der vom=== Operator verwendet wird).NaN-Werte werden niemals als gleich angesehen, daher gibtindexOf() immer-1 zurück, wennsearchElementNaN ist.

DieindexOf()-Methode überspringt leere Stellen indünn besiedelten Arrays.

DieindexOf()-Methode istgenerisch. Sie erwartet nur, dass derthis Wert einelength-Eigenschaft und integer-indexierte Eigenschaften hat.

Beispiele

Verwendung von indexOf()

Das folgende Beispiel verwendetindexOf(), um Werte in einem Array zu lokalisieren.

js
const array = [2, 9, 9];array.indexOf(2); // 0array.indexOf(7); // -1array.indexOf(9, 2); // 2array.indexOf(2, -1); // -1array.indexOf(2, -3); // 0

Sie könnenindexOf() nicht verwenden, um nachNaN zu suchen.

js
const array = [NaN];array.indexOf(NaN); // -1

Finden aller Vorkommen eines Elements

js
const indices = [];const array = ["a", "b", "a", "c", "a", "d"];const element = "a";let idx = array.indexOf(element);while (idx !== -1) {  indices.push(idx);  idx = array.indexOf(element, idx + 1);}console.log(indices);// [0, 2, 4]

Prüfen, ob ein Element im Array vorhanden ist, und das Array aktualisieren

js
function updateVegetablesCollection(veggies, veggie) {  if (veggies.indexOf(veggie) === -1) {    veggies.push(veggie);    console.log(`New veggies collection is: ${veggies}`);  } else {    console.log(`${veggie} already exists in the veggies collection.`);  }}const veggies = ["potato", "tomato", "chillies", "green-pepper"];updateVegetablesCollection(veggies, "spinach");// New veggies collection is: potato,tomato,chillies,green-pepper,spinachupdateVegetablesCollection(veggies, "spinach");// spinach already exists in the veggies collection.

Verwendung von indexOf() bei dünn besiedelten Arrays

Sie könnenindexOf() nicht verwenden, um nach leeren Stellen in dünn besiedelten Arrays zu suchen.

js
console.log([1, , 3].indexOf(undefined)); // -1

Aufruf von indexOf() bei Nicht-Array-Objekten

DieindexOf()-Methode liest dielength-Eigenschaft vonthis und greift auf jede Eigenschaft zu, deren Schlüssel eine nicht-negative Ganzzahl kleiner alslength ist.

js
const arrayLike = {  length: 3,  0: 2,  1: 3,  2: 4,  3: 5, // ignored by indexOf() since length is 3};console.log(Array.prototype.indexOf.call(arrayLike, 2));// 0console.log(Array.prototype.indexOf.call(arrayLike, 5));// -1

Spezifikationen

Specification
ECMAScript® 2026 Language Specification
# sec-array.prototype.indexof

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

[8]ページ先頭

©2009-2025 Movatter.jp