JavaScript Array includes() Método
Objeto Array de JavaScriptEjemplo
Detectar el arraysiteSi contiene ejemplo:
let site = ['ejemplo', 'google', 'taobao'];
site.includes('ejemplo');
// true
site.includes('baidu');
// false
Pruébalo »
Definición y uso
El método includes() se utiliza para determinar si un array contiene un valor especificado. Si es así, devuelve true; de lo contrario, false.
[1, 2, 3].includes(2); // true [1, 2, 3].includes(4); // false [1, 2, 3].includes(3, 3); // false [1, 2, 3].includes(3, -1); // true [1, 2, NaN].includes(NaN); // true
Compatibilidad del navegador
Los números en la tabla representan el número de versión del primer navegador compatible con este método.
| Método | |||||
|---|---|---|---|---|---|
| includes() | 47 | 14 | 43 | 9 | 34 |
Sintaxis
arr.includes(searchElement) arr.includes(searchElement, fromIndex)
Descripción de parámetros
| Parámetro | Descripción |
|---|---|
| searchElement | Requerido. El valor del elemento que se necesita buscar. |
| fromIndex | Opcional. Comienza la búsqueda de searchElement desde este índice. Si es negativo, la búsqueda comienza desde el índice array.length + fromIndex, en orden ascendente. Por defecto es 0. |
Detalles técnicos
| Valor de retorno: | Booleano. Devuelve true si se encuentra el valor especificado; de lo contrario, devuelve false. |
|---|---|
| Versión de JavaScript: | ECMAScript 6 |
Más ejemplos
fromIndex mayor o igual que la longitud del array
Si fromIndex es mayor o igual que la longitud del array, devuelve false. El array no se buscará:
Ejemplo
var arr = ['a', 'b', 'c'];
arr.includes('c', 3); //false
arr.includes('c', 100); // false
El índice calculado es menor que 0
Si fromIndex es un valor negativo, el índice calculado se utilizará como posición de inicio para buscar searchElement. Si el índice calculado es menor que 0, se buscará en todo el array.
Ejemplo
//La longitud del array es 3
//fromIndex es -100
//el índice calculado es 3 + (-100) = -97
var arr = ['a', 'b', 'c'];
arr.includes('a', -100); // true
arr.includes('b', -100); // true
arr.includes('c', -100); // true