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 July 2015.
Resumen
El método search()
ejecuta una búsqueda que encaje entre una expresión regular y el objeto String
desde el que se llama.
Sintaxis
str.search(expresionregular)
Parámetros
- regexp
-
Un objeto expresión regular. Si se pasa un objeto
obj
que 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 utiliza search()
(si sólo deseas saber si existe, utiliza el método test()
del prototipo de RegExp
); para más información (pero de ejecución más lenta) utiliza match()
(similar al método exec()
de las expresiones regulares).
Ejemplos
Utilizando search()
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 Language Specification # sec-string.prototype.search |
Compatibilidad con navegadores
BCD tables only load in the browser