TypedArray.prototype.subarray()

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

TypedArray 实例的 subarray() 返回一个新的、基于相同 ArrayBuffer、元素类型也相同的类型化数组。开始的索引将会被包括，而结束的索引将不会被包括。

尝试一下

const uint8 = new Uint8Array([10, 20, 30, 40, 50]);

console.log(uint8.subarray(1, 3));
// Expected output: Uint8Array [20, 30]

console.log(uint8.subarray(1));
// Expected output: Uint8Array [20, 30, 40, 50]

语法

js
subarray()
subarray(begin)
subarray(begin, end)

参数

begin 可选

元素开始的索引，开始索引的元素将会被包括。若该值没有传入，将会返回一个拥有全部元素的数组。

end 可选

元素结束的索引，结束索引的元素将不会被包括。若该值没有传入，从 begin 所指定的那一个元素到数组末尾的所有元素都将会被包含进新数组中。

返回值

一个新的 TypedArray 对象。

说明

  • 被 begin 和 end 指定的范围将会收束与当前数组的有效索引
  • 若计算后得出的长度是负数，将会被收束成 0
  • 若 begin 或 end 是负数，将会被当做成是从数组末端读取的索引

需要注意的是，使用该方法返回的新数组还是建立在原有的 Buffer 之上的，所以，改动数组的内容将会影响到原数组，反之亦然。

Examples

Using the subarray method

js
var buffer = new ArrayBuffer(8);
var uint8 = new Uint8Array(buffer);
uint8.set([1, 2, 3]);

console.log(uint8); // Uint8Array [ 1, 2, 3, 0, 0, 0, 0, 0 ]

var sub = uint8.subarray(0, 4);

console.log(sub); // Uint8Array [ 1, 2, 3, 0 ]

Specifications

Specification
ECMAScript® 2026 Language Specification
# sec-%typedarray%.prototype.subarray

Browser compatibility

See also