Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / JavaScript

String.prototype.search — encontrar el índice de una coincidencia

El método search() encuentra la primera coincidencia de una expresión regular y devuelve su índice o -1. Un argumento de tipo cadena se interpreta como un patrón, no como una subcadena literal.

Versión: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxis

string.search(regexp)

String.prototype.search devuelve el índice de la primera coincidencia de un RegExp ordinario, o -1 si no hay ninguna. El índice empieza en cero y se mide en unidades de código UTF-16, no en caracteres visibles. El método no modifica la cadena ni devuelve la subcadena coincidente. Comprueba el resultado con !== -1: el índice 0 indica que sí hay coincidencia.

Si el argumento tiene un método [Symbol.search] invocable, ya sea propio o heredado, search() lo llama en lugar de crear una nueva expresión regular. Las instancias ordinarias de RegExp heredan este método de RegExp.prototype. Si el argumento es null o undefined, o si al consultar su propiedad [Symbol.search] se obtiene null o undefined, search() crea una expresión regular a partir del argumento. Cualquier otro valor no invocable de esa propiedad provoca un TypeError. Por eso, "abc".search(".") devuelve 0: . coincide con cualquier carácter excepto un terminador de línea, no con un punto literal. Usa indexOf() para buscar texto literal. Omitir el argumento o pasar undefined crea un patrón vacío y produce 0.

Con un RegExp ordinario, la bandera g no recopila todas las coincidencias. La búsqueda comienza con lastIndex establecido en 0 y, al terminar normalmente, se restaura su valor anterior. La bandera y sigue exigiendo una coincidencia al principio de la cadena. El método no acepta un argumento de posición inicial.

Un método [Symbol.search] personalizado puede definir por completo el comportamiento, incluido el tipo del resultado. En el ejemplo, los dígitos empiezan en el índice 7, lastIndex permanece en 8 y la falta de coincidencia produce -1.

Ejemplos

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("."));

Resultado

7
8
-1
0

El código mostrado y el resultado declarado se verificaron en un entorno aislado mediante el método registrado en la evidencia de verificación de esta versión exacta.

Fuentes