此页面由社区从英文翻译而来。了解更多并加入 MDN Web Docs 社区。

View in English Always switch to English

ArrayBuffer.prototype.slice()

基线 广泛可用

自 2015年7月 起,此特性已在主流浏览器中得到支持,可在大多数设备和浏览器版本中正常使用。

ArrayBuffer 实例的 slice() 方法返回一个新的 ArrayBuffer 实例,其包含原 ArrayBuffer 实例中从 begin 开始(包含)到 end 结束(不含)的所有字节的副本。

尝试一下

// Create an ArrayBuffer with a size in bytes
const buffer = new ArrayBuffer(16);
const int32View = new Int32Array(buffer);
// Produces Int32Array [0, 0, 0, 0]

int32View[1] = 42;
const sliced = new Int32Array(buffer.slice(4, 12));
// Produces Int32Array [42, 0]

console.log(sliced[0]);
// Expected output: 42

语法

js
slice()
slice(start)
slice(start, end)

参数

start 可选

要开始提取的位置索引(从 0 开始),将被转换为整数

  • 负数索引将会从缓冲区末尾开始计算——如果 start < 0,那么将会使用 start + buffer.length
  • 如果 start < -buffer.length 或省略了 start,则会使用 0
  • 如果 start >= buffer.length,则不会提取任何内容。
end 可选

要结束提取的位置索引(从 0 开始),将被转换为整数slice() 提取到但不包括 end

  • 负数索引将会从缓冲区末尾开始计算——如果 end < 0,那么将会使用 end + buffer.length
  • 如果 end < -buffer.length,则会使用 0
  • 如果 end >= buffer.length 或省略了 end,则会使用 buffer.length,则会导致直到末尾的所有元素都被提取。
  • 如果标准化后的 end 位置在 start 位置之前,则不会提取任何内容。

返回值

一个新的 ArrayBuffer 对象。

示例

复制一个 ArrayBuffer

js
const buf1 = new ArrayBuffer(8);
const buf2 = buf1.slice(0);

规范

规范
ECMAScript® 2027 Language Specification
# sec-arraybuffer.prototype.slice

浏览器兼容性

参见