CKTIS / JavaScript
String.prototype.includes — comprobar si hay una subcadena
String.prototype.includes comprueba si un texto contiene una subcadena determinada y devuelve true o false. Distingue entre mayúsculas y minúsculas, permite indicar una posición inicial y no acepta expresiones regulares ordinarias.
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
str.includes(searchString)
str.includes(searchString, position)String.prototype.includes busca una subcadena literal y devuelve true o false sin modificar el texto. Distingue entre mayúsculas y minúsculas y compara unidades de código UTF-16: no normaliza Unicode ni aplica reglas de comparación propias de cada idioma.
El parámetro opcional position indica el índice inicial más temprano posible para una coincidencia, contado desde cero en unidades de código UTF-16. Su valor predeterminado es 0; tras convertirlo a número, la parte fraccionaria se trunca hacia cero y el resultado se limita al intervalo entre 0 y la longitud del texto. Si el método llega a la fase de búsqueda, devuelve true con un searchString vacío, aunque la posición indicada supere la longitud del texto. Sin embargo, position se convierte antes de la búsqueda: pasar un BigInt como position lanza un TypeError incluso si searchString está vacío.
Un objeto RegExp ordinario usado como searchString provoca un TypeError; formalmente, esto lo determina la comprobación IsRegExp, que tiene en cuenta Symbol.match. Los demás argumentos de búsqueda se convierten en texto, así que, si se omite el argumento, se busca "undefined". Llamar al método con null o undefined como this provoca un TypeError.
Este es un método de la biblioteca estándar de ECMAScript, no una API web. La compatibilidad con un navegador concreto debe comprobarse por separado; que esté disponible en Node 24 no demuestra que sea compatible con los navegadores.
Ejemplos
const text = "JavaScript";
console.log(text.includes("Script"));
console.log(text.includes("script"));
console.log(text.includes("Java", 1));
console.log(text.includes("", 99));
try {
text.includes(/Script/);
} catch (error) {
console.log(error.name);
}Resultado
true false false true TypeError
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.