Esta página ha sido traducida del inglés por la comunidad.Aprende más y únete a la comunidad de MDN Web Docs.
String.prototype.search()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julio de 2015.
Resumen
El métodosearch() ejecuta una búsqueda que encaje entre una expresión regular y el objetoString desde el que se llama.
Sintaxis
str.search(expresionregular)
Parámetros
- regexp
Un objetoexpresión regular. Si se pasa un objeto
objque no sea una expresión regular, se convierte implicitamente en una expresión regualar usandonew RegExp(obj).
Valor devuelto
El índice de la primera coincidencia entre la expresión regular y la cadena de texto proporcionada, si no se encuentra devuelve-1.
Descripción
Cuando se desee saber en qué casos un patrón se encuentra en una cadena de texto utilizasearch() (si sólo deseas saber si existe, utiliza el métodotest() del prototipo deRegExp); para más información (pero de ejecución más lenta) utilizamatch() (similar al métodoexec() de las expresiones regulares).
Ejemplos
Utilizandosearch()
El siguiente ejemplo imprime un mensaje dependiendo de cuál sea el resultado de la evaluación.
function testinput(re, str) { var midstring; if (str.search(re) != -1) { midstring = " contains "; } else { midstring = " does not contain "; } console.log(str + midstring + re);}Especificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.search |