From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/web/api/filereader/index.html | 159 +++++++++++++++++++++++++++++++++ 1 file changed, 159 insertions(+) create mode 100644 files/ja/web/api/filereader/index.html (limited to 'files/ja/web/api/filereader/index.html') diff --git a/files/ja/web/api/filereader/index.html b/files/ja/web/api/filereader/index.html new file mode 100644 index 0000000000..8d8d799866 --- /dev/null +++ b/files/ja/web/api/filereader/index.html @@ -0,0 +1,159 @@ +--- +title: FileReader +slug: Web/API/FileReader +tags: + - API + - DOM + - File API + - FileReader + - Files + - Interface + - Reference + - インターフェイス +translation_of: Web/API/FileReader +--- +
{{APIRef("File API")}}
+ +

FileReader オブジェクトを使用すると、Web アプリケーションは、ユーザーのコンピュータに保存されているファイル (または生データ バッファ) の内容を非同期に読み取ることができます。{{domxref("File")}} または {{domxref("Blob")}} オブジェクトを使用して、読み込むファイルまたはデータを指定します。

+ +

File オブジェクトは、{{HTMLElement("input")}} 要素を使用してファイルを選択した結果として返される {{domxref("FileList")}} オブジェクト、ドラッグ＆ドロップ操作の {{domxref("DataTransfer")}} オブジェクト、または {{domxref("HTMLCanvasElement")}} 上の mozGetAsFile() API から取得することができます。

+ +
+

重要事項: FileReader は、ユーザーの (リモートの) システムから安全な方法でのみファイルの内容を読み取るために使用されます。単にファイルシステムからパス名でファイルを読み込むためには使用できません。JavaScript でパス名でファイルを読み込むには、標準的な Ajax ソリューションを使用してサーバーサイドのファイル読み込みを行い、クロスドメインでファイルを読み込む場合は CORS パーミッションを使用しなければなりません。

+
+ +

{{AvailableInWorkers}}

+ +

コンストラクター

+ +
+
{{domxref("FileReader.FileReader", "FileReader()")}}
+
新しく作成された FileReader を返します。
+
+ +

詳細や例については Web アプリケーションからのファイルの使用 を参照してください。

+ +

プロパティ

+ +
+
{{domxref("FileReader.error")}} {{readonlyinline}}
+
ファイルの読み込み中に発生したエラーを表す {{domxref("DOMException")}}。
+
{{domxref("FileReader.readyState")}} {{readonlyinline}}
+
FileReader の状態を示す数値。以下のいずれかになります。 + + + + + + + + + + + + + + + + + + +
EMPTY0まだデータは読み込まれていません。
LOADING1データは現在読み込み中です。
DONE2読込リクエストがすべて終了しました。
+
+
{{domxref("FileReader.result")}} {{readonlyinline}}
+
ファイルの内容。このプロパティは読み込み操作が完了した後にのみ有効であり、データのフォーマットは、どのメソッドが読み込み操作を開始するのに使用されたかに依存します。
+
+ +

イベントハンドラ

+ +
+
{{domxref("FileReader.onabort")}}
+
{{event("abort")}} イベントのハンドラです。このイベントは、読み込み操作が中止されるたびにトリガされます。
+
{{domxref("FileReader.onerror")}}
+
{{event("error")}} イベントのハンドラです。このイベントは、読み込み操作がエラーになるたびにトリガされます。
+
{{domxref("FileReader.onload")}}
+
{{event("load")}} イベントのハンドラです。このイベントは、読み込み操作が正常に完了するたびにトリガされます。
+
{{domxref("FileReader.onloadstart")}}
+
{{event("loadstart")}} イベントのハンドラです。このイベントは、読み込みが開始されるたびにトリガされます。
+
{{domxref("FileReader.onloadend")}}
+
{{event("loadend")}} イベントのハンドラです。このイベントは、 (成功または失敗のいずれかで) 読み込み操作が完了するたびにトリガされます。
+
{{domxref("FileReader.onprogress")}}
+
{{event("progress")}} イベントのハンドラです。このイベントは、{{domxref("Blob")}} コンテンツの読み込み中に発生します。
+
+ +
+

FileReader は {{domxref("EventTarget")}} を継承しているので、{{domxref("EventTarget.addEventListener()", "addEventListener")}} メソッドを使用することで、これらのイベントをすべて待ち受けることもできます。

+
+ +

メソッド

+ +
+
{{domxref("FileReader.abort()")}}
+
読込処理を中断します。結果として readyState は DONE に変わります。
+
{{domxref("FileReader.readAsArrayBuffer()")}} {{gecko_minversion_inline("7.0")}}
+
指定された {{domxref("Blob")}} の内容の読み込みを開始し、終了すると、result 属性にファイルのデータを表す {{domxref("ArrayBuffer")}} が格納されます。
+
{{domxref("FileReader.readAsBinaryString()")}} {{non-standard_inline}}
+
指定された {{domxref("Blob")}} の内容の読み込みを開始し、終了すると、result 属性にはファイルからの生のバイナリデータが文字列として格納されます。
+
{{domxref("FileReader.readAsDataURL()")}}
+
指定された {{domxref("Blob")}} の内容の読み込みを開始し、終了すると、result 属性にはファイルのデータを表す data: の URL が格納されます。
+
{{domxref("FileReader.readAsText()")}}
+
指定された {{domxref("Blob")}} の内容の読み込みを開始し、終了すると result 属性にファイルの内容がテキスト文字列として格納されます。オプションでエンコーディング名を指定することができます。
+
+ +

イベント

+ +

{{domxref("EventTarget/addEventListener", "addEventListener()")}} を使用するか、このインターフェイスの onイベント名 プロパティにイベントリスナーを代入するかして、これらのイベントを待ち受けます。

+ +
+
{{domxref("FileReader/abort_event", "abort")}}
+
プログラムが {{domxref("FileReader.abort()")}} を呼び出したなどの原因で、読み取り操作が中断されたときに発生します。
+ {{domxref("FileReader/onabort", "onabort")}} プロパティ経由でも利用できます。
+
{{domxref("FileReader/error_event", "error")}}
+
エラーのために読み取りが失敗したときに発生します。
+ {{domxref("FileReader/onerror", "onerror")}} プロパティ経由でも利用できます。
+
{{domxref("FileReader/load_event", "load")}}
+
読み取りが正常に完了したときに発生します。
+ {{domxref("FileReader/onload", "onload")}} プロパティ経由でも利用できます。
+
{{domxref("FileReader/loadend_event", "loadend")}}
+
正常かどうかにかかわらず、読み取りが完了したときに発生します。
+ {{domxref("FileReader/onloadend", "onloadend")}} プロパティ経由でも利用できます。
+
{{domxref("FileReader/loadstart_event", "loadstart")}}
+
読み取りが開始されたときに発生します。
+ {{domxref("FileReader/onloadstart", "onloadstart")}} プロパティ経由でも利用できます。
+
{{domxref("FileReader/progress_event", "progress")}}
+
データの読み取り時に定期的に発生します。
+ {{domxref("FileReader/onprogress", "onprogress")}} プロパティ経由でも利用できます。
+
+ +

仕様

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName("File API", "#dfn-filereader", "FileReader")}}{{Spec2("File API")}}初回定義
+ +

ブラウザの対応

+ + + +

{{Compat("api.FileReader")}}

+ +

あわせて参照

+ + -- cgit v1.2.3-54-g00ecf