TypedArray.prototype.every()

The every() method tests whether all elements in the typed array pass the test implemented by the provided function. This method has the same algorithm as Array.prototype.every(). TypedArray is one of the typed array types here.

Syntax

// Arrow function
every((element) => { ... } )
every((element, index) => { ... } )
every((element, index, array) => { ... } )

// Callback function
every(callbackFn)
every(callbackFn, thisArg)

// Inline callback function
every(function callbackFn(element) { ... })
every(function callbackFn(element, index) { ... })
every(function callbackFn(element, index, array){ ... })
every(function callbackFn(element, index, array) { ... }, thisArg)

Parameters

callbackFn

A function to test for each element, taking three arguments:

element

The current element being processed in the typed array.

index Optional

The index of the current element being processed in the typed array.

array Optional

The typed array every was called upon.

thisArg Optional

A value to use as this when executing callbackFn.

Return value

true if the callback function returns a truthy value for every array element; otherwise, false.

Description

The every method executes the provided callbackFn function once for each element present in the typed array until it finds the one where callbackFn returns a falsy value. If such an element is found, the every method immediately returns false. Otherwise, if callbackFn returns a truthy value for all elements, every returns true.

callbackFn is invoked with three arguments: the value of the element, the index of the element, and the typed array object being traversed.

If a thisArg parameter is provided to every, it will be used as callback's this value. Otherwise, the value undefined will be used as its this value. The this value ultimately observable by callbackFn is determined according to the usual rules for determining the this seen by a function.

every does not mutate the typed array on which it is called.

Examples

Testing size of all typed array elements

The following example tests whether all elements in the typed array are bigger than 9.

function isBigEnough(element, index, array) {
  return element >= 10;
}
new Uint8Array([12, 5, 8, 130, 44]).every(isBigEnough);   // false
new Uint8Array([12, 54, 18, 130, 44]).every(isBigEnough); // true

Testing typed array elements using arrow functions

Arrow functions provide a shorter syntax for the same test.

new Uint8Array([12, 5, 8, 130, 44]).every(elem => elem >= 10); // false
new Uint8Array([12, 54, 18, 130, 44]).every(elem => elem >= 10); // true

Specifications

Specification
ECMAScript Language Specification (ECMAScript)
# sec-%typedarray%.prototype.every

Browser compatibility

BCD tables only load in the browser

See also