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 un arreglo incluye un elemento determinado, regresa truefalse según corresponda.

Sintaxis

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

Parámetros

searchElement
El elemento a buscar.
fromIndex
Opcional. La posición en éste arreglo 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.

Regresa

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.
Living Standard  

Compatibilidad de navegadores

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: patoezequiel, Estoja, degj21, wffranco, DRayX
 Última actualización por: patoezequiel,