FileReader

Este articulo necesita una revisión técnica. Cómo puedes ayudar.

Este articulo necesita una revisión editorial. Cómo puedes ayudar.

Sumario

El objeto FileReader permite a las aplicaciones web una lectura asíncrona del contenido de archivos (o información de los datos en bruto) almacenados en el ordenador del usuario, usando {{domxref ("File")}} o {{domxref ("Blob")}} objetos para especificar el archivo o de datos a leer.

Los objetos File pueden ser obtenidos de un objeto FileList devuelto como resultado de una selección de archivos por parte del usuario usando el elemento <input>, de una operación de drag and drop de un objeto DataTransfer, o de la API mozGetAsFile() API en un HTMLCanvasElement.

Constructor

FileReader FileReader();

Vea Uso de archivos desde aplicaciones web para más detalles y ejemplos.

Propiedades

FileReader.error Read only
Un DOMError representa el error que ocurre mientras se lee un archivo.
FileReader.readyState Read only
Un númeo que indica el estado de FileReader. This will be one of the State constants.
FileReader.result Read only
El contenido del archivo. Esta propiedad solamente es válida después de que la operación de lectura ha sido completada, y el formato de los datos depende de qué método fue utilizado para 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.

Constantes de State

  • EMPTY   : 0 : No se han cargado datos.
  • LOADING : 1 : Los datos estan siendo cargados actualmente.
  • DONE    : 2 : La totalidad de la petición de lectura ha sido completada.

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

Especificación Estado Comentario
File API
The definition of 'FileReader' in that specification.
Working Draft Definición inicial.

Browser compatibility

Característica Firefox (Gecko) Chrome Internet Explorer* Opera* Safari
Soporte básico 3.6 (1.9.2) 7 10 12.02 6.0.2
Característica Firefox Mobile (Gecko) Android IE Mobile Opera Mobile Safari Mobile
Soporte básico 32 3 10 11.5 6.1

Notas de implementación

Notas específicas para Gecko

  • Antes de Gecko 2.0 beta 7 (Firefox 4.0 beta 7), todos los parámetros Blob de a continuación eran parámetros File; esto ya se ha actualizado para que coincida con la especificación correcta.
  • Antes de Gecko 13.0 (Firefox 13.0 / Thunderbird 13.0 / SeaMonkey 2.10) la propiedad FileReader.error devolvía un objeto FileError. Esta interface ha sido eliminada y FileReader.error ahora devielve el objeto DOMError tal y como se define en el último borrador de FileAPI.

See also

Etiquetas y colaboradores del documento

 Colaboradores en esta página: israelfl, Carlos-T, Clunaenc, fscholz, cm_rocanroll
 Última actualización por: israelfl,