TypedArray.prototype.with()

Baseline 2023

Newly available

Since July 2023, this feature works across the latest devices and browser versions. This feature might not work in older devices or browsers.

The with() method of TypedArray instances is the copying version of using the bracket notation to change the value of a given index. It returns a new typed array with the element at the given index replaced with the given value. This method has the same algorithm as Array.prototype.with().

Syntax

js
arrayInstance.with(index, value)

Parameters

index

Zero-based index at which to change the typed array, converted to an integer.

value

Any value to be assigned to the given index.

Return value

A new typed array with the element at index replaced with value.

Exceptions

RangeError

Thrown if index >= array.length or index < -array.length.

Description

See Array.prototype.with() for more details. This method is not generic and can only be called on typed array instances.

Examples

Using with()

js
const arr = new Uint8Array([1, 2, 3, 4, 5]);
console.log(arr.with(2, 6)); // Uint8Array [1, 2, 6, 4, 5]
console.log(arr); // Uint8Array [1, 2, 3, 4, 5]

Specifications

Specification
ECMAScript Language Specification
# sec-%typedarray%.prototype.with

Browser compatibility

BCD tables only load in the browser

See also