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
typedarray.every(callback[, thisArg])
Parameters
callback
- Function to test for each element, taking three arguments:
currentValue
- 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
every
was called upon.
thisArg
- Optional. Value to use as
this
when executingcallback
.
Return value
true
if the callback function returns a truthy value for every array element; otherwise, false
.
Description
The every
method executes the provided callback
function once for each element present in the typed array until it finds one where callback
returns a falsy value (a value that becomes false when converted to a Boolean). If such an element is found, the every
method immediately returns false
. Otherwise, if callback
returned a true value for all elements, every
will return true
.
callback
is invoked with three arguments: the value of the element, the index of the element, and the array object being traversed.
If a thisArg
parameter is provided to every
, it will be passed to callback
when invoked, for use as its this
value. Otherwise, the value undefined
will be passed for use as its this
value. The this
value ultimately observable by callback
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 10.
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 | Status | Comment |
---|---|---|
ECMAScript 2015 (6th Edition, ECMA-262) The definition of 'TypedArray.prototype.every' in that specification. |
Standard | Initial definition. |
ECMAScript 2017 Draft (ECMA-262) The definition of 'TypedArray.prototype.every' in that specification. |
Draft |
Browser compatibility
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | 45.0 | 37 (37) | No support | 36.0 | No support |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|
Basic support | No support | No support | 37 (37) | No support | No support | No support |