Array.prototype.contains()

Sumário

O método contains() determina se um array contém um determinado elemento, retornando true ou false apropriadamente.

Sintaxe

array.contains(searchElement[, fromIndex])

Parâmetros

searchElement

O elemento a buscar

fromIndex

Opcional. A posição no array de onde a busca pelo searchElement se iniciará. Por padrão, 0.

Exemplos

[1, 2, 3].contains(2);     // true
[1, 2, 3].contains(4);     // false
[1, 2, 3].contains(3, 3);  // false
[1, 2, 3].contains(3, -1); // true
[1, 2, NaN].contains(NaN); // true

Polyfill

if (![].contains) {
  Object.defineProperty(Array.prototype, 'contains', {
    enumerable: false,
    configurable: true,
    writable: true,
    value: function(searchElement/*, fromIndex*/) {
      if (this === undefined || this === null) {
        throw new TypeError('Cannot convert this value to object');
      }
      var O = Object(this);
      var len = parseInt(O.length) || 0;
      if (len === 0) { return false; }
      var n = parseInt(arguments[1]) || 0;
      if (n >= len) { return false; }
      var k;
      if (n >= 0) {
        k = n;
      } else {
        k = len + n;
        if (k < 0) k = 0;
      }
      while (k < len) {
        var currentElement = O[k];
        if (searchElement === currentElement ||
            searchElement !== searchElement && currentElement !== currentElement
        ) {
          return true;
        }
        k++;
      }
      return false;
    }
  });
}

Especificações

Proposta ES7: https://github.com/domenic/Array.prototype.contains/blob/master/spec.md

Comptibilidade

Veja Também

• Array.prototype.indexOf()
• String.prototype.contains()