---
title: SharedArrayBuffer.prototype.slice()
slug: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/slice
tags:
  - SharedArrayBuffer
  - slice
translation_of: Web/JavaScript/Reference/Global_Objects/SharedArrayBuffer/slice
---
<div>{{JSRef}}</div>

<p><code><strong>SharedArrayBuffer.prototype.slice()</strong></code> 方法返回一个新的{{jsxref("SharedArrayBuffer")}} 副本，其内容是<code>该SharedArrayBuffer</code>的字节从<code>begin</code>开始(包含<code>begin</code>)，直到<code>end</code>结束(不包含<code>end</code>)。如果<code>begin</code>或<code>end</code>是负的，它指的是从数组末尾开始的索引。此方法与 {{jsxref("Array.prototype.slice()")}} 具有相同的算法。</p>

<p>{{EmbedInteractiveExample("pages/js/sharedarraybuffer-slice.html")}}</p>

<h2 id="语法">语法</h2>

<pre class="syntaxbox"><var>sab</var>.slice()
<var>sab</var>.slice(begin)
<var>sab</var>.slice(begin, end)</pre>

<h3 id="参数">参数</h3>

<dl>
 <dt><code>begin</code> {{optional_inline}}</dt>
 <dd>从零开始的索引，从该索引开始提取。</dd>
 <dd>可以使用一个负索引，表示从序列末尾开始的偏移量。 <code>slice(-2)</code>提取序列中的最后两个元素。</dd>
 <dd>If <code>begin</code> is undefined, <code>slice</code> begins from index <code>0</code>.如果<code>begin</code>为undefined，<code>slice</code>则从索引为<code>0</code>处开始。</dd>
 <dt><code>end</code> {{optional_inline}}</dt>
 <dd>从零开始的索引，在此索引<em>之前</em>终止提取。 <code>slice</code> 执行提取到索引为<code>end</code>的位置(不包含<code>end</code>)。</dd>
 <dd>例如，<code>slice(1,4)</code>提取第二个元素到第四个元素（索引为1、2和3的元素）。</dd>
 <dd>可以使用一个负索引，表示从序列末尾开始的偏移量。 <code>slice(2,-1)</code>提取序列中从第三个元素开始，到倒数第二个元素结束的全部元素。</dd>
 <dd>如果省略<code>end</code>，则<code>slice</code>一直提取到序列的末尾（<code>sab.byteLength）。</code></dd>
</dl>

<h3 id="返回值">返回值</h3>

<p>一个包含被提取出的元素的新 {{jsxref("SharedArrayBuffer")}} 。</p>

<h2 id="例子">例子</h2>

<pre class="brush:js">var sab = new SharedArrayBuffer(1024);
sab.slice();    // SharedArrayBuffer { byteLength: 1024 }
sab.slice(2);   // SharedArrayBuffer { byteLength: 1022 }
sab.slice(-2);  // SharedArrayBuffer { byteLength: 2 }
sab.slice(0, 1); // SharedArrayBuffer { byteLength: 1 }
</pre>

<h2 id="规范">规范</h2>

<table class="standard-table">
 <tbody>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
  <tr>
   <td>{{SpecName('ESDraft', '#sec-sharedarraybuffer.prototype.slice', 'SharedArrayBuffer.prototype.slice')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td>Initial definition in ES2017.</td>
  </tr>
 </tbody>
</table>

<h2 id="浏览器兼容性">浏览器兼容性</h2>



<p>{{Compat("javascript.builtins.SharedArrayBuffer.slice")}}</p>

<h2 id="相关链接">相关链接</h2>

<ul>
 <li>{{jsxref("SharedArrayBuffer")}}</li>
 <li>{{jsxref("Array.prototype.slice()")}}</li>
</ul>