FileReader

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨julio de 2015⁩.

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 objetosFile oBlob dependiendo de los datos que se pretenden leer.

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

Constructor

FileReader FileReader();

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

Propiedades

FileReader.errorRead only

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

FileReader.readyStateRead 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.resultRead 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 eventoabort. Este evento se activa cada vez que se interrumpe la operación de lectura.
FileReader.onerror: Un controlador para el eventoerror. Este evento se activa cada vez que la operación de lectura encuentra un error.
FileReader.onload: Un controlador para el eventoload. Este evento se activa cada vez que la operación de lectura se ha completado satisfactoriamente.
FileReader.onloadstart: Un controlador para el eventoloadstart. Este evento se activa cada vez que comienza la lectura.
FileReader.onloadend: Un controlador para el eventoloadend. 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 eventoprogress. Este evento se activa mientras se está leyendo el contenido del objetoBlob.

Nota:ComoFileReader hereda deEventTarget, todos esos eventos también pueden ser escuchados usando el métodoaddEventListener.

Métodos

FileReader.abort(): Interrumpe la operación de lectura. A su regresoreadyState seráDONE.
FileReader.readAsArrayBuffer(): Comienza la lectura del contenido del objetoBlob especificado, una vez terminada, el atributoresult contiene unArrayBuffer representando los datos del fichero.
FileReader.readAsBinaryString(): Comienza la lectura del contenido del objetoBlob, una vez terminada, el atributoresult contiene los datos binarios en bruto del archivo como una cadena.
FileReader.readAsDataURL(): Comienza la lectura del contenido del objetoBlob, una vez terminada, el atributoresult contiene undata: URL que representa los datos del fichero.
FileReader.readAsText(): Comienza la lectura del contenido del objetoBlob, una vez terminada, el atributoresult contiene el contenido del fichero como una cadena de texto.