FileReader

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

Sumario

El objeto FileReader permite que las aplicaciones web lean ficheros (o información en buffer) almacenados en el cliente de forma asíncrona, usando los objetos File o Blob dependiendo de los datos que se pretenden leer.

El objeto File puede ser obtenido desde un objeto FileList devuelto como resultado de la selección de archivos por parte del usuario en un elemento <input>, desde el objeto DataTransfer producido por una operación de arrastre (drag and drop) o desde la API mozGetAsFile () en un HTMLCanvasElement.

Constructor

FileReader FileReader();

Mira el artículo Using files from web applications para más detalles y ejemplos.

Propiedades

FileReader.error Read only

Un DOMError que representa el error que ocurrió al momento de leer el archivo.

FileReader.readyState Read only

Devuelve un entero que indica el estado de FileReader. Puede ser uno de los siguientes:

EMPTY 0 No ha sido leido ningún dato aún.
LOADING 1 La información está siendo leída.
DONE 2 Se ha completado la solicitud de lectura.
FileReader.result Read only

El contenido del fichero. Esta propieda es válida solo cuando la propiedad FileReader.readyState es 2, es decir, cuando la lectura ha finalizado. El formato de la información depende de los métodos usados al iniciar la operación de lectura.

Controladores de eventos

FileReader.onabort

Un controlador para el evento abort. Este evento se activa cada vez que se interrumpe la operación de lectura.

FileReader.onerror

Un controlador para el evento error. Este evento se activa cada vez que la operación de lectura encuentra un error.

FileReader.onload

Un controlador para el evento load. Este evento se activa cada vez que la operación de lectura se ha completado satisfactoriamente.

FileReader.onloadstart

Un controlador para el evento loadstart. Este evento se activa cada vez que comienza la lectura.

FileReader.onloadend

Un controlador para el evento loadend. Este evento se activa cada vez que la operación de lecura se ha completado (ya sea con éxito o fallo).

FileReader.onprogress

Un controlador para el evento progress. Este evento se activa mientras se está leyendo el contenido del objeto Blob.

Nota: Como FileReader hereda de EventTarget, todos esos eventos también pueden ser escuchados usando el método addEventListener.

Métodos

FileReader.abort()

Interrumpe la operación de lectura. A su regreso readyState será DONE.

FileReader.readAsArrayBuffer()

Comienza la lectura del contenido del objeto Blob especificado, una vez terminada, el atributo result contiene un ArrayBuffer representando los datos del fichero.

FileReader.readAsBinaryString()

Comienza la lectura del contenido del objeto Blob, una vez terminada, el atributo result contiene los datos binarios en bruto del archivo como una cadena.

FileReader.readAsDataURL()

Comienza la lectura del contenido del objeto Blob, una vez terminada, el atributo result contiene un data: URL que representa los datos del fichero.

FileReader.readAsText()

Comienza la lectura del contenido del objeto Blob, una vez terminada, el atributo result contiene el contenido del fichero como una cadena de texto.

Especificaciones

Specification
File API
# APIASynch

Compatibilidad con navegadores

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
FileReader
FileReader() constructor
abort
abort event
error
error event
load event
loadend event
loadstart event
progress event
readAsArrayBuffer
readAsBinaryString
Deprecated
readAsDataURL
readAsText
readyState
result
Available in workers

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Deprecated. Not for use in new websites.
See implementation notes.
Has more compatibility info.

See also