De methode findIndex() geeft de index terug van het eerste element in de array waarvoor de gegeven functie voldoet. Indien er geen element wordt gevonden, zal -1 teruggegeven worden.
De broncode van dit interactieve voorbeeld is terug te vinden in een GitHub repository. Als je wil bijdragen aan het interactieve voorbeelden project, clone dan https://github.com/mdn/interactive-examples en stuur ons een pull request.
Zie ook de methode find(), die een waarde teruggeeft van het gevonden element in plaats van de index.
De functie die wordt uitgevoerd voor elk element in de array, met volgende drie argumenten:
Het huidig te evalueren element uit de array.
De index van het huidig te evalueren element binnen de array.
De array waarop de methode findIndex was aangeroepen.
Optioneel. Het object dat als this kan gebruikt worden tijdens de uitvoer van callback.
De index binnen de array van het gevonden element; anders, -1.
De methode findIndex voert de callback function uit voor elke index uit de array 0..length-1 (inclusief) tot wanneer er een element is waarvoor callback een waarde teruggeeft overeenkomstig met true. Als zo een element wordt gevonden, dan geeft findIndex onmiddellijk de index terug van deze iteratie. Als de functie voor geen enkel element voldoet of als length van de array 0 is, zal findIndex -1 teruggeven. In tegenstelling tot andere array methodes zoals Array#some, wordt callback ook aangeroepen ook voor indexen zonder element in de array.
callback heeft drie argumenten: de waarde van het element, de index van het element, en het Array element dat wordt doorlopen.
Als een thisArg parameter wordt opgegeven voor findIndex zal het gebruikt worden als this bij elke aanroep van callback. Als het niet wordt opgegeven dan wordt undefined gebruikt.
findIndex past de array waarop het wordt aangeroepen niet aan.
De reeks van elementen verwerkt door findIndex wordt opgemaakt voor de eerste aanroep van callback. Elementen die aan de array worden toegevoegd na de aanroep van findIndex zullen niet worden doorlopen door callback. Als een bestaand element, dat nog niet werd doorlopen, aangepast wordt door callback, dan zal deze waarde doorgegeven aan callback; verwijderde elementen worden ook doorlopen.
Vind de index van een priemgetal in een array
Het volgende voorbeeld toont hoe een priemgetal kan gevonden worden in een array met getallen (of -1 als er geen priemgetal in de array zit).
Vind index met een arrow function
Het volgende voorbeeld toont hoe een element uit de array fruits kan gevonden worden met de arrow function syntax.
Als je echt verouderde JavaScript engines moet blijven ondersteunen die Object.defineProperty niet supporteren, is het beter van Array.prototype methodes helemaal niet te voorzien als polyfill, omdat je ze toch niet niet-enumereerbaar kan maken.
De compatibility tabel van deze pagina werd gegenereerd uit gestructureerde data. Als je wil bijdragen verwijzen we naar https://github.com/mdn/browser-compat-data en stuur ons een pull request.
Chrome Volledige ondersteuning 45 Edge Volledige ondersteuning 12 Firefox Volledige ondersteuning 25 IE Geen ondersteuning Nee Opera Volledige ondersteuning 32 Safari Volledige ondersteuning 8 WebView Android Volledige ondersteuning 45 Chrome Android Volledige ondersteuning 45 Firefox Android Volledige ondersteuning 4 Opera Android Volledige ondersteuning 32 Safari iOS Volledige ondersteuning 8 Samsung Internet Android Volledige ondersteuning 5.0 nodejs Volledige ondersteuning 4.0.0