Según la MDN el método includes()
de JavaScript fue lanzado en la versión ES6 del lenguaje y solo podía ser usado con cadenas de texto, posteriormente el método se extiende para su uso en arreglos para la especificación ES7, en otras palabras:
-
includes()
en ES6: se aplica a strings. -
includes()
en ES7: se aplica a arrays.
Pero, ¿para que sirve exactamente este método? 🤔
En ambos casos y en síntesis, includes
realiza una búsqueda en el string o en el array y retorna un valor boleano según sea el caso; true
si encuentra el valor y false
sino lo encuentra.
Sintaxis
string.includes('valor a buscar', posicion);
or
array.includes('valor a buscar', posicion);
Donde:
- string y array representa el tipo de variable donde se aplicará el método respectivamente.
-
posicion
es un entero opcional que representa la el índice desde el cual se desea realizar la búsqueda.
Son suficientes conceptos teóricos, ahora veamos ejemplos prácticos:
includes()
aplicado a strings
let nombre = "Cristian Fernando Villca Gutierrez";
let res = nombre.includes("Fernando");
console.log(res); //true
El siguiente ejemplo devolverá por consola true
ya que el parámetro Fernando
pasado a includes
si está en la cadena nombre
.
Ahora le pasaremos un parámetro índex opcional y analizaremos que es lo que sucede:
let nombre = "Cristian Fernando Villca Gutierrez";
let res = nombre.includes("Fernando",17);
console.log(res); //false
Ahora la salida del ejemplo es false
, ya que la búsqueda se empieza a realizar desde la posición 17 del string, por lo que no encuentra la palabra Fernando
.
includes()
aplicado a arrays
La manera de usar includes()
con arreglos es bastante similar a usarla con un string:
const mi_arreglo = ["Hola", 25, "perro", false];
let res = mi_arreglo.includes("perro");
console.log(res); // true
La cadena perro
ocupa la 2da posición del arreglo, por ende la salida es true
.
const mi_arreglo = ["Hola", 25, "perro", false];
let res = mi_arreglo.includes("gato");
console.log(res);
Al buscar la palabra gato
la salida es false
ya que el string no contiene ninguna posición con ese valor.
Nota: De igual manera es posible pasarle un parámetro opcional numérico para que la búsqueda se realice desde un índex determinado.
¿includes()
aplicado a objetos?
includes()
es un método que solo se puede usar en strings y arrays, no puede usarse en objetos, si se deseara hacer algo parecido con un objeto se tendrían que buscar otros caminos.
const mi_objeto = {
nombre: "Cristian",
edad:24,
soltero: false
};
if('nombre' in mi_objeto){
console.log("nombre existe");
}else{
console.log("nombre no existe");
}
Conclusiones
-
includes()
realiza búsquedas en strings y arrays. - Las búsquedas por defecto se realizan desde la posición 0 de la cadena o del arreglo.
- Es posible modificar este comportamiento añadiendo un 2do parámetro opcional entero para realizar la búsqueda.
- Siempre retorna
true
ofalse
dependiendo del éxito o no de la búsqueda. - No es posible usarlo en objetos
Top comments (0)