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(element) { /* ... */ })
every(function(element, index) { /* ... */ })
every(function(element, index, array){ /* ... */ })
every(function(element, index, array) { /* ... */ }, thisArg)
Parameters
callbackFn-
A function to test for each element.
The function is called with the following arguments:
element-
The current element being processed in the typed array.
index-
The index of the current element being processed in the typed array.
array-
The typed array
everywas called upon.
thisArgOptional-
A value to use as
thiswhen executingcallbackFn.
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 # sec-%typedarray%.prototype.every |
Browser compatibility
BCD tables only load in the browser