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

JavaScript
<var>typedarray</var>.<code>every(<var>callback</var>[, <var>thisArg</var>])</code>

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 executing callback.

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.

JavaScript
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.

JavaScript
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

See also

License

© 2016 Mozilla Contributors
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-us/docs/web/javascript/reference/global_objects/typedarray/every

ECMAScript6 JavaScript Method Prototype TypedArray TypedArrays