From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- files/tr/web/api/filereader/index.html | 162 +++++++++++++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 files/tr/web/api/filereader/index.html (limited to 'files/tr/web/api/filereader') diff --git a/files/tr/web/api/filereader/index.html b/files/tr/web/api/filereader/index.html new file mode 100644 index 0000000000..6a9742f8d1 --- /dev/null +++ b/files/tr/web/api/filereader/index.html @@ -0,0 +1,162 @@ +--- +title: FileReader +slug: Web/API/FileReader +tags: + - API + - DOM + - File API + - Files + - NeedsTranslation + - Reference + - TopicStub + - WebAPI +translation_of: Web/API/FileReader +--- +
{{APIRef("File API")}}
+ +

The FileReader object lets web applications asynchronously read the contents of files (or raw data buffers) stored on the user's computer, using {{domxref("File")}} or {{domxref("Blob")}} objects to specify the file or data to read.

+ +

File objects may be obtained from a {{domxref("FileList")}} object returned as a result of a user selecting files using the {{HTMLElement("input")}} element, from a drag and drop operation's DataTransfer object, or from the mozGetAsFile() API on an {{domxref("HTMLCanvasElement")}}.

+ +

Constructor

+ +
FileReader FileReader();
+ +

See Using files from web applications for details and examples.

+ +

Properties

+ +
+
{{domxref("FileReader.error")}} {{readonlyinline}}
+
A {{domxref("DOMError")}} representing the error that occurred while reading the file.
+
{{domxref("FileReader.readyState")}} {{readonlyinline}}
+
A number indicating the state of the FileReader. This will be one of the {{anch("State constants")}}.
+
{{domxref("FileReader.result")}} {{readonlyinline}}
+
The file's contents. This property is only valid after the read operation is complete, and the format of the data depends on which of the methods was used to initiate the read operation.
+
+ +

Event handlers

+ +
+
{{domxref("FileReader.onabort")}}
+
A handler for the {{event("abort")}} event. This event is triggered each time the reading operation is aborted.
+
{{domxref("FileReader.onerror")}}
+
A handler for the {{event("error")}} event. This event is triggered each time the reading operation encounter an error.
+
{{domxref("FileReader.onload")}}
+
A handler for the {{event("load")}} event. This event is triggered each time the reading operation is successfully completed.
+
{{domxref("FileReader.onloadstart")}}
+
A handler for the {{event("loadstart")}} event. This event is triggered each time the reading is starting.
+
{{domxref("FileReader.onloadend")}}
+
A handler for the {{event("loadend")}} event. This event is triggered each time the reading operation is completed (either in success or failure).
+
{{domxref("FileReader.onprogress")}}
+
A handler for the {{event("progress")}} event. This event is triggered while reading a {{domxref("Blob")}} content.
+
+ +
+

Note: As FileReader inherits from {{domxref("EventTarget")}}, all those events can also be listened for by using the {{domxref("EventTarget.addEventListener()","addEventListener")}} method.

+
+ +

State constants

+ + + +

Methods

+ +
+
{{domxref("FileReader.abort()")}}
+
Aborts the read operation. Upon return, the readyState will be DONE.
+
{{domxref("FileReader.readAsArrayBuffer()")}} {{gecko_minversion_inline("7.0")}}
+
Starts reading the contents of the specified {{domxref("Blob")}}, once finished, the result attribute contains an {{domxref("ArrayBuffer")}} representing the file's data.
+
{{domxref("FileReader.readAsBinaryString()")}}
+
Starts reading the contents of the specified {{domxref("Blob")}}, once finished, the result attribute contains the raw binary data from the file as a string.
+
{{domxref("FileReader.readAsDataURL()")}}
+
Starts reading the contents of the specified {{domxref("Blob")}}, once finished, the result attribute contains a data: URL representing the file's data.
+
{{domxref("FileReader.readAsText()")}}
+
Starts reading the contents of the specified {{domxref("Blob")}}, once finished, the result attribute contains the contents of the file as a text string.
+
+ +

Specifications

+ + + + + + + + + + + + + + +
SpecificationStatusComment
{{SpecName("File API", "#FileReader-interface", "FileReader")}}{{Spec2("File API")}}Initial definition
+ +

Browser compatibility

+ +

{{CompatibilityTable}}

+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureFirefox (Gecko)ChromeInternet ExplorerOperaSafari
Basic support{{CompatGeckoDesktop("1.9.2")}}[1]710[2]12.02[3]6.0.2
+
+ +
+ + + + + + + + + + + + + + + + + + + +
FeatureFirefox Mobile (Gecko)AndroidIE MobileOpera MobileSafari Mobile
Basic support3231011.56.1
+
+ +

[1] Prior to Gecko 2.0 beta 7 (Firefox 4.0 beta 7), all {{domxref("Blob")}} parameters below were {{domxref("File")}} parameters; this has since been updated to match the specification correctly. Prior to Gecko 13.0 {{geckoRelease("13.0")}} the FileReader.error property returned a {{domxref("FileError")}} object. This interface has been removed and FileReader.error is now returning the {{domxref("DOMError")}} object as defined in the latest FileAPI draft.

+ +

[2] IE9 has a File API Lab.

+ +

[3] Opera has partial support in 11.1.

+ +

See also

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