Esta traducción está incompleta. Por favor, ayuda a traducir este artículo del inglés.

This is an experimental technology, part of the ECMAScript 2016 (ES7) proposal.
Because this technology's specification has not stabilized, check the compatibility table for usage in various browsers. Also note that the syntax and behavior of an experimental technology is subject to change in future version of browsers as the spec changes.

El método includes() determina si una matriz incluye un elemento determinado, devuelve truefalse según corresponda.

Sintaxis

var boolean = array.includes(searchElement[, fromIndex])

Parámetros

searchElement
El elemento a buscar.
fromIndex Optional
Posición en la matriz en la cuál se debe comenzar a buscar searchElement. Un valor negativo inicia la busqueda desde array.length + fromIndex en adelante. El valor por defecto es 0.

Valor de retorno

Un Boolean.

Ejemplos

[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

Polyfill

if (!Array.prototype.includes) {
  Array.prototype.includes = function(searchElement /*, fromIndex*/ ) {
    'use strict';
    var O = Object(this);
    var len = parseInt(O.length) || 0;
    if (len === 0) {
      return false;
    }
    var n = parseInt(arguments[1]) || 0;
    var k;
    if (n >= 0) {
      k = n;
    } else {
      k = len + n;
      if (k < 0) {k = 0;}
    }
    var currentElement;
    while (k < len) {
      currentElement = O[k];
      if (searchElement === currentElement ||
         (searchElement !== searchElement && currentElement !== currentElement)) {
        return true;
      }
      k++;
    }
    return false;
  };
}

Especificaciones

 

Especificación Estatus Comentarios
ECMAScript 2016 (ECMA-262)
La definición de 'Array.prototype.includes' en esta especificación.
Standard Definición inicial.
ECMAScript Latest Draft (ECMA-262)
La definición de 'Array.prototype.includes' en esta especificación.
Draft  

Compatibilidad de navegadores

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Caracteristica Chrome Firefox (Gecko) Internet Explorer Edge Opera Safari
Soporte básico

47

43 Sin soporte 14 34 9
Caracteristica Android Android Webview Firefox Mobile (Gecko) IE Mobile Opera Mobile Safari Mobile Chrome for Android
Soporte básico Sin soporte

47

43 Sin soporte 34 9

47

Ver también

Etiquetas y colaboradores del documento

 Colaboradores en esta página: jorgeyp, patoezequiel, Estoja, degj21, wffranco, DRayX
 Última actualización por: jorgeyp,