Mozilla's getting a new look. What do you think? https://mzl.la/brandsurvey

Array.prototype.includes()

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 (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.

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)
The definition of 'Array.prototype.includes' in that specification.
Standard Definición initial.
ECMAScript 2017 Draft (ECMA-262)
The definition of 'Array.prototype.includes' in that specification.
Draft  

Compatibilidad de navegadores

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

47

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

47

43 No support 34 9

47

Ver también

Etiquetas y colaboradores del documento

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