W3cubDocs

/JavaScript

typedArray.filter

The filter() method creates a new typed array with all elements that pass the test implemented by the provided function. This method has the same algorithm as Array.prototype.filter(). TypedArray is one of the typed array types here.

Syntax

typedarray.filter(callback[, thisArg])

Parameters

callback
Function to test each element of the typed array. Invoked with arguments (element, index, typedarray). Return true to keep the element, false otherwise.
thisArg Optional
Value to use as this when executing callback.

Return value

A new typed array with the elements that pass the test.

Description

The filter() method calls a provided callback function once for each element in a typed array, and constructs a new typed array of all the values for which callback returns a true value. callback is invoked only for indexes of the typed array which have assigned values; it is not invoked for indexes which have been deleted or which have never been assigned values. Typed array elements which do not pass the callback test are simply skipped, and are not included in the new typed array.

callback is invoked with three arguments:

  1. the value of the element
  2. the index of the element
  3. the typed array object being traversed

If a thisArg parameter is provided to filter, 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.

filter() does not mutate the typed array on which it is called.

The range of elements processed by filter() is set before the first invocation of callback. Elements which are appended to the typed array after the call to filter() begins will not be visited by callback. If existing elements of the typed array are changed, or deleted, their value as passed to callback will be the value at the time filter() visits them; elements that are deleted are not visited.

Examples

Filtering out all small values

The following example uses filter() to create a filtered typed array that has all elements with values less than 10 removed.

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

Filtering typed array elements using arrow functions

Arrow functions provide a shorter syntax for the same test.

new Uint8Array([12, 5, 8, 130, 44]).filter(elem => elem >= 10); 
// Uint8Array [ 12, 130, 44 ]

Specifications

Browser compatibilityUpdate compatibility data on GitHub

Desktop
Chrome Edge Firefox Internet Explorer Opera Safari
filter 45 14 38 No No 9.1
Mobile
Android webview Chrome for Android Firefox for Android Opera for Android Safari on iOS Samsung Internet
filter No 45 38 No 9.3 5.0
Server
Node.js
filter 4.0.0

See also

© 2005–2018 Mozilla Developer Network and individual contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://wiki.developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/TypedArray/filter