CKTIS / JavaScript
String.prototype.indexOf — een substring zoeken
String.prototype.indexOf geeft de index van de eerste vindplaats van een substring vanaf de startpositie die ontstaat door position om te zetten en te begrenzen, of -1 als de substring daar niet voorkomt. De methode is hoofdlettergevoelig en meet indices in UTF-16-code-eenheden.
Versie: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntax
string.indexOf(searchString)
string.indexOf(searchString, position)String.prototype.indexOf zoekt naar een letterlijke substring zonder de tekst te wijzigen. Het zoeken begint op de positie die ontstaat door position om te zetten en te begrenzen. De methode geeft de index van de eerste overeenkomst terug, of -1 als er geen overeenkomst is. Indices beginnen bij 0 en staan voor UTF-16-code-eenheden, niet noodzakelijk voor volledige zichtbare tekens. De zoekactie is hoofdlettergevoelig.
Het optionele argument position heeft standaard de waarde 0. Het wordt omgezet naar een geheel getal door het fractionele deel naar nul af te ronden en vervolgens begrensd op het bereik van 0 tot de tekstlengte. NaN betekent 0. Als de omzetting van position slaagt en searchString leeg is, geeft de methode de zo bepaalde positie terug, ook als die aan het einde van de tekst ligt. Geef je 0n mee als position, dan geeft de methode al vóór het zoeken een TypeError.
searchString wordt omgezet naar een tekenreeks; als het argument ontbreekt, wordt gezocht naar "undefined". De methode interpreteert geen reguliere expressies: ook een meegegeven RegExp-object wordt omgezet naar een tekenreeks.
Controleer of de substring voorkomt met result !== -1, niet met if (result): index 0 is falsy, terwijl -1 truthy is. In het voorbeeld verandert position waar de zoekactie begint, maar de teruggegeven index verwijst nog steeds naar de volledige tekst.
Voorbeelden
const text = "banana";
console.log(text.indexOf("ana"));
console.log(text.indexOf("ana", 2));
console.log(text.indexOf("B"));
console.log(text.indexOf("", 99));
console.log(text.indexOf("ban") !== -1);Resultaat
1 3 -1 6 true
De getoonde code en het opgegeven resultaat zijn in een geïsoleerde omgeving geverifieerd met de methode die in het verificatiebewijs voor exact deze versie is vastgelegd.