CKTIS / JavaScript
String.prototype.search — de index van een patroonmatch vinden
De methode search() vindt de eerste match van een reguliere expressie en geeft de index daarvan terug, of -1. Een string als argument wordt als patroon geïnterpreteerd, niet als letterlijke substring.
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.search(regexp)String.prototype.search geeft de index van de eerste match met een gewone RegExp terug, of -1 als er geen match is. De index begint bij nul en wordt gemeten in UTF-16-code-eenheden, niet in zichtbare tekens. De methode verandert de string niet en geeft de gematchte substring niet terug. Controleer het resultaat met !== -1: index 0 betekent dat er een match is.
Als het argument een aanroepbare [Symbol.search]-methode heeft, roept search() die aan in plaats van een nieuwe reguliere expressie te maken. Het maakt niet uit of de methode een eigen of een overgeërfde eigenschap is. Gewone RegExp-instanties erven deze methode van RegExp.prototype. Als het argument null of undefined is, of als het opvragen van de eigenschap [Symbol.search] van het argument null of undefined oplevert, maakt search() een reguliere expressie op basis van het argument. Elke andere niet-aanroepbare waarde van die eigenschap leidt tot een TypeError. Daarom geeft "abc".search(".") de waarde 0 terug: . matcht elk teken behalve een regeleindeteken, niet een letterlijke punt. Gebruik indexOf() om letterlijke tekst te zoeken. Het argument weglaten of undefined doorgeven maakt een leeg patroon en levert 0 op.
Bij een gewone RegExp verzamelt de vlag g niet alle matches. De zoekactie begint met lastIndex op 0; na normale afronding wordt de eerdere waarde hersteld. De vlag y vereist nog steeds een match aan het begin van de string. De methode accepteert geen argument voor een startpositie.
Een aangepaste [Symbol.search]-methode kan het gedrag volledig bepalen, inclusief het type resultaat. In het voorbeeld beginnen de cijfers op index 7, blijft lastIndex gelijk aan 8 en levert een ontbrekende match -1 op.
Voorbeelden
const text = "Order: 42";
const pattern = /\d+/g;
pattern.lastIndex = 8;
console.log(text.search(pattern));
console.log(pattern.lastIndex);
console.log(text.search(/missing/));
console.log("abc".search("."));Resultaat
7 8 -1 0
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.