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 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.errorRead only-
Un
DOMErrorque 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:
EMPTY0No ha sido leido ningún dato aún. LOADING1La información está siendo leída. DONE2Se 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 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 objetoBlob.
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
readyStateseráDONE. FileReader.readAsArrayBuffer()-
Comienza la lectura del contenido del objeto
Blobespecificado, una vez terminada, el atributoresultcontiene unArrayBufferrepresentando los datos del fichero. FileReader.readAsBinaryString()-
Comienza la lectura del contenido del objeto
Blob, una vez terminada, el atributoresultcontiene los datos binarios en bruto del archivo como una cadena. FileReader.readAsDataURL()-
Comienza la lectura del contenido del objeto
Blob, una vez terminada, el atributoresultcontiene undata:URL que representa los datos del fichero. FileReader.readAsText()-
Comienza la lectura del contenido del objeto
Blob, una vez terminada, el atributoresultcontiene el contenido del fichero como una cadena de texto.
Especificaciones
| Specification |
|---|
| File API # APIASynch |
Compatibilidad con navegadores
Loading…