Sprawdzanie warunku dla wszystkich elementów - every

(interpretuje: Internet Explorer 9, Firefox, Opera, Chrome)

Array.prototype.every(callbackfn)
Array.prototype.every(callbackfn, thisArg)

Parametry:

Function callbackfn - funkcja testująca przyjmująca argumenty:

• kValue - element tablicy
• Number k - indeks elementu tablicy
• Array O - oryginalna tablica

thisArg - wartość bieżącego obiektu this dostępnego w czasie wywołania wewnątrz ciała funkcji (domyślnie: undefined)

Wartość:

Boolean - czy dla wszystkich elementów tablicy funkcja testująca zwraca wartość true

Wyjątki:

TypeError - callbackfn nie jest funkcją

Pozwala sprawdzić, czy wszystkie elementy tablicy spełniają określony warunek. Elementy, które nie zostały jawnie dodane do tablicy, są pomijane.

Jest odpowiednikiem operatora && (i - ang. and) przy działaniach na wartościach skalarnych.

Przykład Array.prototype.every

var items = [3, 2, 1];
 
var f = function (x) {
    return x > 0;
};
items.every(f);                   // true
 
f = function (x) {
    return x < 0;
};
items.every(f);                   // false
 
var GreaterThan = function (value) {
    this.value = value;
    this.tests = 0;
};
GreaterThan.prototype.test = function (value) {
    ++this.tests;
    return value > this.value;
};
 
var tester = new GreaterThan(0);
items.every(tester.test, tester); // true
tester.tests;                     // 3
 
tester = new GreaterThan(2);
items.every(tester.test, tester); // false
tester.tests;                     // 2
 
items = [1, 2];
items[3] = 3;
items.length;                     // 4
tester = new GreaterThan(0);
items.every(tester.test, tester); // true
tester.tests;                     // 3
 
items.every(null);                // TypeError
items.every(undefined);           // TypeError
items.every({});                  // TypeError