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

CKTIS / JavaScript

String.prototype.indexOf — buscar una subcadena

String.prototype.indexOf devuelve el índice de la primera aparición de una subcadena a partir de la posición inicial que se obtiene al convertir y limitar position, o -1 si no hay coincidencia. Distingue entre mayúsculas y minúsculas y mide los índices en unidades de código UTF-16.

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.indexOf(searchString)
string.indexOf(searchString, position)

String.prototype.indexOf busca una subcadena literal sin modificar el texto. La búsqueda empieza en la posición que se obtiene al convertir y limitar position. El método devuelve el índice de la primera coincidencia, o -1 si no hay ninguna. Los índices empiezan en 0 y representan unidades de código UTF-16, que no siempre equivalen a caracteres visibles completos. La búsqueda distingue entre mayúsculas y minúsculas.

El argumento opcional position tiene el valor predeterminado 0. Se convierte en un entero truncando la parte fraccionaria hacia cero y, después, se limita al intervalo entre 0 y la longitud del texto. NaN equivale a 0. Si la conversión de position se realiza correctamente y searchString es una cadena vacía, el método devuelve la posición así obtenida, aunque esté al final del texto. Si se pasa 0n como valor de position, el método lanza una excepción TypeError antes de que empiece la búsqueda.

searchString se convierte en una cadena; si se omite, se busca "undefined". El método no interpreta expresiones regulares: un objeto RegExp proporcionado también se convierte en una cadena.

Comprueba si la subcadena está presente con result !== -1, no con if (result): el índice 0 es falsy, mientras que -1 es truthy. En el ejemplo, position cambia el punto donde comienza la búsqueda, pero el índice devuelto sigue refiriéndose al texto completo.

Ejemplos

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);

Resultado

1
3
-1
6
true

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