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.includes()
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since septiembre de 2015.
El métodoincludes() determina si una cadena de texto puede ser encontrada dentro de otra cadena de texto, devolviendotrue ofalse según corresponda.
Pruébalo
const sentence = "The quick brown fox jumps over the lazy dog.";const word = "fox";console.log( `The word "${word}" ${ sentence.includes(word) ? "is" : "is not" } in the sentence`,);// Expected output: "The word "fox" is in the sentence"Sintaxis
str.includes(searchString[, position])
Parametros
searchStringUna cadena a buscar en el texto
str.positionOpcionalLa posición dentro de la cadena en la cual empieza la búsqueda de
searchString(Por defecto este valor es 0).
Valor devuelto
true si la cadena de texto contiene la cadena buscada; en caso contrario,false.
Descripción
Este método permite determinar si una cadena de texto se encuentra incluida dentro de la otra.
Sensibilidad a Mayúsculas/Minúsculas
El métodoincludes() es "case sensitive" (tiene en cuenta mayúsculas y minúsculas). Por ejemplo, la siguiente expresión devolveráfalse:
"Ballena azul".includes("ballena"); // devuelve falsePolyfill
Este método ha sido agregado a la especificación ECMAScript 2015 y puede no estar disponible en toda las implementaciones de JavaScript.
Sin embargo, puedes usar este método como polyfill:
if (!String.prototype.includes) { String.prototype.includes = function (search, start) { "use strict"; if (search instanceof RegExp) { throw TypeError("first argument must not be a RegExp"); } if (start === undefined) { start = 0; } return this.indexOf(search, start) !== -1; };}Ejemplos
Usandoincludes()
const str = "To be, or not to be, that is the question.";console.log(str.includes("To be")); // trueconsole.log(str.includes("question")); // trueconsole.log(str.includes("nonexistent")); // falseconsole.log(str.includes("To be", 1)); // falseconsole.log(str.includes("TO BE")); // falseconsole.log(str.includes("")); // trueEspecificaciones
| Specification |
|---|
| ECMAScript® 2026 Language Specification # sec-string.prototype.includes |