大网数据广告活动
Web 标准与前端开发

TypedArray.prototype.set()

· 52CE 我爱测

TypedArray 实例的 **`set()`** 方法用于将多个值存入类型化数组中,这些值会从指定的数组中读取。

TypedArray 实例的 set() 方法用于将多个值存入类型化数组中,这些值会从指定的数组中读取。

JavaScript 演示:TypedArray.prototype.set()

// 创建一个以字节为单位指定大小的 ArrayBuffer
const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

// 从索引 3 开始将这些值复制到数组中
uint8.set([1, 2, 3], 3);

console.log(uint8);
// 预期输出:Uint8Array [0, 0, 0, 1, 2, 3, 0, 0]

语法

set(array)
set(array, targetOffset)

set(typedarray)
set(typedarray, targetOffset)

参数

  • array
    • : 要复制其值的源数组。源数组中的所有值都会被复制到目标数组中,除非源数组的长度加上目标偏移量超过目标数组的长度,在这种情况下会抛出异常。
  • typedarray
    • : 如果源数组是类型化数组,这两个数组可能共享同一个底层 ArrayBuffer;此时 JavaScript 引擎会智能地将缓冲区中源范围的数据复制到目标范围。
  • targetOffset
    • : 指定在目标数组中开始写入源数组值的偏移位置。如果省略此参数,则默认为 0(即源数组将从索引 0 开始覆盖目标数组中的值)。

返回值

无(undefined)。

异常

  • RangeError
    • : 在以下情况之一中会抛出该错误:
      • 由于 targetOffset 过大,array 或者 typedarray 的长度过长,导致元素将被存储到类型化数组的末尾之外。
      • targetOffset 为负数。

示例

使用 set()

const buffer = new ArrayBuffer(8);
const uint8 = new Uint8Array(buffer);

uint8.set([1, 2, 3], 3);

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

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。