2021/09/15 時点の英語版に同期

1 files changed, 84 insertions, 80 deletions

diff --git a/files/ja/web/api/xmlhttprequest/upload/index.md b/files/ja/web/api/xmlhttprequest/upload/index.md
index a570608060..7bef31baaf 100644
--- a/files/ja/web/api/xmlhttprequest/upload/index.md
+++ b/files/ja/web/api/xmlhttprequest/upload/index.md
@@ -5,99 +5,103 @@ tags:
   - AJAX
   - API
   - Monitoring XMLHttpRequest
-  - Property
-  - Read-only
-  - Reference
-  - Sending Files
-  - Uploading
+  - プロパティ
+  - 読み取り専用
+  - リファレンス
+  - ファイル送信
+  - アップロード
   - XHR
-  - XHR Uploads
+  - XHR アップロード
   - XMLHttpRequest
-  - XMLHttpRequest Uploads
+  - XMLHttpRequest アップロード
   - XMLHttpRequestUpload
-  - upload
   - アップロード
-  - ファイル送信
+browser-compat: api.XMLHttpRequest.upload
 translation_of: Web/API/XMLHttpRequest/upload
 ---
-<div>{{APIRef('XMLHttpRequest')}}</div>
+{{APIRef('XMLHttpRequest')}}
 
-<p><span class="seoSummary">{{domxref("XMLHttpRequest")}} の <code>upload</code> プロパティは、アップロードの進捗を監視することができる {{domxref("XMLHttpRequestUpload")}} オブジェクトを返します。</span>これは不透過なオブジェクトですが、 {{domxref("XMLHttpRequestEventTarget")}} でもあるため、進捗を追跡するために添付することができます。</p>
+{{domxref("XMLHttpRequest")}} の `upload` プロパティは、アップロードの進捗を監視することができる {{domxref("XMLHttpRequestUpload")}} オブジェクトを返します。
 
-<p>以下のイベントは upload オブジェクトを起動してアップロードを監視する目に使用することができます。</p>
+これは不透過なオブジェクトですが、 {{domxref("XMLHttpRequestEventTarget")}} でもあるため、進捗を追跡するためにイベントリスナーを装着することができます。
 
-<table class="standard-table">
- <tbody>
-  <tr>
-   <td class="header">イベント</td>
-   <td class="header">イベントリスナー</td>
-   <td class="header">解説</td>
-  </tr>
-  <tr>
-   <td>{{event("loadstart")}}</td>
-   <td>{{domxref("XMLHttpRequest.onloadstart", "onloadstart")}}</td>
-   <td>アップロードが始まった。</td>
-  </tr>
-  <tr>
-   <td>{{event("progress")}}</td>
-   <td>{{domxref("XMLHttpRequest.onprogress", "onprogress")}}</td>
-   <td>進捗の量を示すために定期的に発生する。</td>
-  </tr>
-  <tr>
-   <td>{{event("abort")}}</td>
-   <td>{{domxref("XMLHttpRequest.onabort", "onabort")}}</td>
-   <td>アップロード操作が中断された。</td>
-  </tr>
-  <tr>
-   <td>{{event("error")}}</td>
-   <td>{{domxref("XMLHttpRequest.onerror", "onerror")}}</td>
-   <td>アップロードがエラーのために失敗した。</td>
-  </tr>
-  <tr>
-   <td>{{event("load")}}</td>
-   <td>{{domxref("XMLHttpRequest.onload", "onload")}}</td>
-   <td>アップロードが完全に成功した。</td>
-  </tr>
-  <tr>
-   <td>{{event("timeout")}}</td>
-   <td>{{domxref("XMLHttpRequest.ontimeout", "ontimeout")}}</td>
-   <td>返事が {{domxref("XMLHttpRequest.timeout")}} で指定された時間間隔内に届かなかったため、アップロードがタイムアウトされた。</td>
-  </tr>
-  <tr>
-   <td>{{event("loadend")}}</td>
-   <td>{{domxref("XMLHttpRequest.onloadend", "onloadend")}}</td>
-   <td>アップロードが終了した。このイベントでは成功か失敗かを区別することはできず、結果にかかわらずアップロードが終了したときに送信されます。このイベントの前に、 <code>load</code>, <code>error</code>, <code>abort</code>, <code>timeout</code> のうちの1つがアップロードが終了した理由を示すために配信されます。</td>
-  </tr>
- </tbody>
-</table>
+> **Note:** このオブジェクトにイベントリスナーを装着すると、リクエストが「単純なリクエスト」ではなくなり、オリジンをまたぐ場合はプリフライトリクエストが発行されるようになります。 [CORS](/ja/docs/Web/HTTP/CORS) を参照してください。このため、イベントリスナーは {{domxref("XMLHttpRequest.send", "send()")}} を呼び出す前に登録する必要があり、そうしないとアップロードイベントが発行されなくなります。
 
-<h2 id="Specifications" name="Specifications">仕様書</h2>
+> **Note:** また、仕様書では、イベントリスナーは {{domxref("XMLHttpRequest.open", "open()")}} の後に装着すべきとされているようです。しかし、ブラウザーはこの点に関してバグが多く、リスナーを {{domxref("XMLHttpRequest.open", "open()")}} の前に登録しないと動作しないことがよくあります。
 
-<table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-   <th scope="col">状態</th>
-   <th scope="col">備考</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('XMLHttpRequest', '#the-upload-attribute')}}</td>
-   <td>{{Spec2('XMLHttpRequest')}}</td>
-   <td>WHATWG living standard</td>
-  </tr>
- </tbody>
+以下のイベントは、アップロードオブジェクト上で発行され、アップロードを監視するために使用することができます。
+
+<table class="no-markdown">
+  <thead>
+    <tr>
+      <th>イベント</th>
+      <th>イベントリスナー</th>
+      <th>解説</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>{{domxref("XMLHttpRequest/loadstart_event", "loadstart")}}</td>
+      <td>
+        {{domxref("XMLHttpRequest.onloadstart", "onloadstart")}}
+      </td>
+      <td>アップロードが始まった。</td>
+    </tr>
+    <tr>
+      <td>{{domxref("XMLHttpRequest/progress_event", "progress")}}</td>
+      <td>
+        {{domxref("XMLHttpRequest.onprogress", "onprogress")}}
+      </td>
+      <td>
+        進捗を示すために定期的に発行されます。
+      </td>
+    </tr>
+    <tr>
+      <td>{{domxref("XMLHttpRequest/abort_event", "abort")}}</td>
+      <td>{{domxref("XMLHttpRequest.onabort", "onabort")}}</td>
+      <td>アップロード操作が中止された。</td>
+    </tr>
+    <tr>
+      <td>{{domxref("XMLHttpRequest/error_event", "error")}}</td>
+      <td>{{domxref("XMLHttpRequest.onerror", "onerror")}}</td>
+      <td>アップロードがエラーで失敗した。</td>
+    </tr>
+    <tr>
+      <td>{{domxref("XMLHttpRequest/load_event", "load")}}</td>
+      <td>{{domxref("XMLHttpRequest.onload", "onload")}}</td>
+      <td>アップロードが成功裏に完了した。</td>
+    </tr>
+    <tr>
+      <td>{{domxref("XMLHttpRequest/timeout_event", "timeout")}}</td>
+      <td>
+        {{domxref("XMLHttpRequest.ontimeout", "ontimeout")}}
+      </td>
+      <td>
+        {{domxref("XMLHttpRequest.timeout")}} で指定された時間内に返答が届かなかったために、アップロードがタイムアウトした。
+      </td>
+    </tr>
+    <tr>
+      <td>{{domxref("XMLHttpRequest/loadend_event", "loadend")}}</td>
+      <td>
+        {{domxref("XMLHttpRequest.onloadend", "onloadend")}}
+      </td>
+      <td>
+        アップロードが終了した。このイベントは成功か失敗かにかかわらず、アップロードが終了したときに発行されます。このイベントより前に、 <code>load</code>, <code>error</code>, <code>abort</code>, <code>timeout</code> の何れかが、アップロードが終了した理由を示すために配信されます。
+      </td>
+    </tr>
+  </tbody>
 </table>
 
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
+## 仕様書
+
+{{Specifications}}
+
+## ブラウザーの互換性
 
-<p>{{Compat("api.XMLHttpRequest.upload")}}</p>
+{{Compat}}
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+## 関連情報
 
-<ul>
- <li><a href="/ja/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest">XMLHttpRequest の使用</a></li>
- <li><a href="/ja/docs/Web/API/File_Handle_API">FileHandle API</a></li>
- <li><a href="/ja/docs/Web/API/File_and_Directory_Entries_API">File and Directory Entries API</a></li>
-</ul>
+- [XMLHttpRequest の使用](/ja/docs/Web/API/XMLHttpRequest/Using_XMLHttpRequest)
+- [FileHandle API](/ja/docs/Web/API/File_Handle_API)
+- [File and Directory Entries API](/ja/docs/Web/API/File_and_Directory_Entries_API)