2021/07/21 時点の英語版に同期

1 files changed, 71 insertions, 67 deletions

diff --git a/files/ja/web/javascript/reference/operators/await/index.md b/files/ja/web/javascript/reference/operators/await/index.md
index 775ce4a787..238761230a 100644
--- a/files/ja/web/javascript/reference/operators/await/index.md
+++ b/files/ja/web/javascript/reference/operators/await/index.md
@@ -2,49 +2,49 @@
 title: await
 slug: Web/JavaScript/Reference/Operators/await
 tags:
-  - Function
+  - 関数
   - JavaScript
-  - Language feature
-  - Operator
+  - 言語機能
+  - 演算子
   - Primary Expression
+browser-compat: javascript.operators.await
 translation_of: Web/JavaScript/Reference/Operators/await
 ---
-<div>{{jsSidebar("Operators")}}</div>
+{{jsSidebar("Operators")}}
 
-<p><code>await</code> 演算子は、{{jsxref("Statements/async_function", "async function")}} によって {{jsxref("Promise")}} が返されるのを待機するために使用します。</p>
+`await` 演算子はプロミス ({{jsxref("Promise")}}) を待つために使用します。通常の JavaScript コードで、 {{jsxref("Statements/async_function", "async function")}} の内部でのみ使用することができます。によって {{jsxref("Promise")}} が返されるのを待機するために使用します。
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+## 構文
 
-<pre class="syntaxbox notranslate">[<em>rv</em>] = await <em>expression</em>;</pre>
+```js
+[rv] = await expression
+```
 
-<dl>
- <dt><code>expression</code></dt>
- <dd>解決を待つ {{jsxref("Promise")}} もしくは何らかの値。</dd>
- <dt><code>rv</code></dt>
- <dd>
- <p>解決された promise の値。expression が <code>Promise</code> ではない場合はその値自体を返す。</p>
- </dd>
-</dl>
+- `expression`
+  - : 待つ {{jsxref("Promise")}} もしくは何らかの値。
+- `rv`
+  - : プロミスの履行された値、または `Promise` ではない場合はその値自体を返します。
 
-<h2 id="Description" name="Description">説明</h2>
+## 解説
 
-<p><code>await</code> 式は <code>async</code> function の実行を一時停止し、<code>Promise</code> の解決または拒否を待ちます。解決した後に <code>async</code> function の実行を再開します。再開するときに <code>await</code> 式は解決された <code>Promise</code> にラップされた値を返します。</p>
+`await` 式は `async` 関数の実行を一時停止し、 `Promise` が決定される（すなわち履行または拒否される）まで待ち、履行された後に `async` 関数の実行を再開します。最下位時に、 `await` 式の値は履行された `Promise` の値になります。
 
-<p><code>Promise</code> が拒否された場合、<code>await</code> 式は理由となった値を投げます。</p>
+`Promise` が拒否された場合、`await` 式は拒否された値で例外を発生させます。
 
-<p><code>await</code> 式に続く値が <code>Promise</code> ではなかった場合、<a href="/ja/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve">解決された Promise</a> に変換されます。</p>
+`await` 演算子に続く*式*の値が `Promise` ではなかった場合、[解決された Promise](/ja/docs/Web/JavaScript/Reference/Global_Objects/Promise/resolve) に変換されます。
 
-<p><code>await</code> は実行フローを分割できるため、<code>await</code> の関数の呼び出し元は、<code>await</code> の関数の遅延継続の前に実行を再開できます。<code>await</code> がその関数の継続を延期した後、これが関数によって実行される最初の <code>await</code> でれば、<code>await</code> の関数の完了を求める保留中の <code>Promise</code> を関数の呼び出し元に返し、その呼び出し元の実行を再開することによって、即時実行も続行されます。</p>
+`await` は実行フローを分割するため、非同期関数の呼び出し元が実行を再開することができます。 `await` がその非同期関数の継続を延期した後は、後続の文が実行されます。この `await` がその関数で実行される最後の式である場合、実行は継続され、 `await` の関数の完了を保留していた `Promise` を呼び出し元に返し、その呼び出し元での実行を再開します。
 
-<h2 id="Examples" name="Examples">例</h2>
+## 例
 
-<h3 id="Awaiting_a_promise_to_be_fulfilled" name="Awaiting_a_promise_to_be_fulfilled">promise の解決を待つ</h3>
+### プロミスの履行を待つ
 
-<p><code>Promise</code> が <code>await</code> 式で停止された場合、<code>Promise</code> が解決されて、解決された値を返すのを待ちます。</p>
+`Promise` が `await` 式に渡された場合、 `Promise` が履行されて履行値を返すのを待ちます。
 
-<pre class="brush: js notranslate">function resolveAfter2Seconds(x) {
-  return new Promise(resolve =&gt; {
-    setTimeout(() =&gt; {
+```js
+function resolveAfter2Seconds(x) {
+  return new Promise(resolve => {
+    setTimeout(() => {
       resolve(x);
     }, 2000);
   });
@@ -56,13 +56,14 @@ async function f1() {
 }
 
 f1();
-</pre>
+```
 
-<h3 id="Thenable_objects" name="Thenable_objects">Thenable オブジェクト</h3>
+### Thenable オブジェクト
 
-<p>{{jsxref("Global_Objects/Promise/then", "Thenable オブジェクト")}}もまったく同じように実行されます。</p>
+{{jsxref("Global_Objects/Promise/then", "Thenable オブジェクト")}}は同様に履行されます。
 
-<pre class="brush: js notranslate">async function f2() {
+```js
+async function f2() {
   const thenable = {
     then: function(resolve, _reject) {
       resolve('resolved!')
@@ -72,24 +73,27 @@ f1();
 }
 
 f2();
-</pre>
+```
 
-<h3 id="Conversion_to_promise" name="Conversion_to_promise">Promise への変換</h3>
+### プロミスへの変換
 
-<p>値が <code>Promise</code> でない場合は、値を解決済みの <code>Promise</code> に変換して待ちます。</p>
+値が `Promise` でない場合は、値を解決済みの `Promise` に変換して待ちます。
 
-<pre class="brush: js notranslate">async function f3() {
+```js
+async function f3() {
   var y = await 20;
   console.log(y); // 20
 }
 
-f3();</pre>
+f3();
+```
 
-<h3 id="Promise_rejection" name="Promise_rejection">Promise の拒否</h3>
+### Promise の拒否
 
-<p><code>Promise</code> が拒否された場合、拒否された値が投げられます。</p>
+`Promise` が拒否された場合、拒否された値で例外が発生します。
 
-<pre class="brush: js notranslate">async function f4() {
+```js
+async function f4() {
   try {
     var z = await Promise.reject(30);
   } catch(e) {
@@ -97,43 +101,43 @@ f3();</pre>
   }
 }
 
-f4();</pre>
+f4();
+```
 
-<h3 id="Handling_rejected_promises" name="Handling_rejected_promises">拒否された Promise を処理する</h3>
+### 拒否された Promise の処理
 
-<p>拒否された <code>Promise</code> は <code>try</code> 文を使用せずにエラーハンドリングを行えます。</p>
+拒否された `Promise` は `try` ブロックなしで処理することができます。
 
-<pre class="brush: js notranslate">var response = await promisedFunction().catch((err) =&gt; { console.error(err); });
-// response will be undefined if the promise is rejected
-</pre>
+```js
+var response = await promisedFunction().catch((err) => { console.error(err); });
+// プロミスが拒否された場合、応答は undefined になります
+```
 
-<h2 id="Specifications" name="Specifications">仕様</h2>
+### 最上位の await
 
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName("ESDraft", "#sec-async-function-definitions", "async functions")}}</td>
-  </tr>
- </tbody>
-</table>
+`await` キーワードは、 [JavaScript モジュール](/ja/docs/Web/JavaScript/Guide/Modules)内では単独で（非同期関数の外で）使用することができます。つまり、 `await` を使う子モジュールを持つモジュールは、子モジュールが実行されるのを待ってから、自分自身が実行されるようになります。他の子モジュールの読み込みをブロックすることなく、実行することができます。
 
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザー実装状況</h2>
+以下は、 [Fetch API](/ja/docs/Web/API/Fetch_API) を使用し、 [`export` 文](/ja/docs/Web/JavaScript/Reference/Statements/export)の中で await を指定したシンプルなモジュールの例です。これを含むすべてのモジュールは、コードを実行する前に読み取りが解決するのを待ちます。
 
-<div>
+```js
+// fetch request
+const colors = fetch('../data/colors.json')
+  .then(response => response.json());
 
+export default await colors;
+```
 
-<p>{{Compat("javascript.operators.await")}}</p>
-</div>
+## 仕様書
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+{{Specifications}}
 
-<ul>
- <li>{{jsxref("Statements/async_function", "async function")}}</li>
- <li>{{jsxref("Operators/async_function", "async function expression")}}</li>
- <li>{{jsxref("AsyncFunction")}} オブジェクト</li>
-</ul>
+## ブラウザーの互換性
+
+{{Compat}}
+
+## 関連情報
+
+- {{jsxref("Statements/async_function", "async function")}}
+- {{jsxref("Operators/async_function", "async function 式")}}
+- {{jsxref("AsyncFunction")}} オブジェクト
+- [最上位の await](https://v8.dev/features/top-level-await) on v8.dev