---
title: Atomics.store()
slug: Web/JavaScript/Reference/Global_Objects/Atomics/store
translation_of: Web/JavaScript/Reference/Global_Objects/Atomics/store
---
<div>{{JSRef}}</div>

<p>静态的Atomics.store（）方法将给定的值存储在数组中的指定位置，并返回该值。.</p>

<div>{{EmbedInteractiveExample("pages/js/atomics-store.html")}}</div>



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

<pre class="syntaxbox">Atomics.store(typedArray, index, value)
</pre>

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

<dl>
 <dt><code>typedArray</code></dt>
 <dd>一个指定类型的shared数组. 类型为 {{jsxref("Int8Array")}}, {{jsxref("Uint8Array")}}, {{jsxref("Int16Array")}}, {{jsxref("Uint16Array")}}, {{jsxref("Int32Array")}}, 或者 {{jsxref("Uint32Array")}}其中一个.</dd>
 <dt><code>index</code></dt>
 <dd>typedArray中用来存储value的位置.</dd>
 <dt><code>value</code></dt>
 <dd>要存储的数字.</dd>
</dl>

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

<p>被存储的值.</p>

<h3 id="异常">异常</h3>

<ul>
 <li>抛出一个{{jsxref("TypeError")}}异常, 如果 <code>typedArray</code> 不是上述给定的类型之一.</li>
 <li>抛出一个{{jsxref("TypeError")}}异常, 如果 <code>typedArray</code> 不是一个指定类型的shared类型数组.</li>
 <li>抛出一个{{jsxref("RangeError")}}异常, 如果 <code>index</code> 在 <code>typedArray</code>中越界了。</li>
</ul>

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

<pre class="brush: js">var sab = new SharedArrayBuffer(1024);
var ta = new Uint8Array(sab);

Atomics.store(ta, 0, 12); // 12</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-atomics.store', 'Atomics.store')}}</td>
   <td>{{Spec2('ESDraft')}}</td>
   <td>Initial definition in ES2017.</td>
  </tr>
 </tbody>
</table>

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

<p>{{Compat("javascript.builtins.Atomics.store")}}</p>

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

<ul>
 <li>{{jsxref("Atomics")}}</li>
 <li>{{jsxref("Atomics.load()")}}</li>
</ul>