File

La interfaz File provee información acerca de los archivos y permite que el código JavaScript en una página web tenga acceso a su contenido.

Los objetos File son generalmente recuperados a través de un objeto FileList (en-US) retornado como resultado de un usuario seleccionado archivos por medio de un elemento <input> , desde las operaciones drag y drop de un objeto  DataTransfer (en-US) , o desde la API mozGetAsFile() en un HTMLCanvasElement. En Gecko, desde código con privilegios es posible crear objetos File representando cualquier archivo local sin esperar la interacción del usuario (ver Implementation notes para más información.)

Un objeto File es una especie específica de Blob, y puede ser utilizada en cualquier contexto que un Blob puede ser usado. En particular, FileReader, URL.createObjectURL(), createImageBitmap() (en-US), y XMLHttpRequest.send() aceptan tanto Blobs y Files.

Ver Utilizando archivos desde aplicaciones web (Using files from web applications) para más información y ejemplos.

Constructor

File() (en-US)
Retorna un nuevo objeto de tipo File.

Propiedades

File.lastModified (en-US)Read only
Retorna el último tiempo que el archivo se modifico, en milisegundos desde la época de UNIX (1 de enero de 1970 a medianoche).
File.lastModifiedDate Read only
Retorna la última fecha (en un objeto DateDate) de modificación del archivo referenciada por el objeto File.
File.nameRead only
Retorna el nombre del archivo referenciada por el objeto File.
File.webkitRelativePath Read only
Retorna la ruta relativa de la URL del File.

File implementa Blob, así que también cuenta con las siguientes propiedades:

File.size (en-US)Read only
Retorna el tamaño del archivo en bytes.
File.type (en-US)Read only
Retorna el tipo MIME del archivo.

Métodos

La interfaz File no define algún método, pero los hereda de la interfaz Blob:

Blob.slice([start[, end[, contentType]]]) (en-US)
Retorna un nuevo objeto Blob conteniendo la información en el rango especificado de bytes de la fuente Blob.
Blob.stream() (en-US)
Transforma el archivo File en un ReadableStream (en-US) que puede ser usado para leer el contenido de File.
Blob.text() (en-US)
Transforma el archivo File en una corriente (stream) para leerse hasta completarse. Retorna una promesa que se resuelve con un USVString (en-US) (texto).
Blob.arrayBuffer() (en-US)
Transforma el archivo File en una corriente y leerlo hasta completarse. Devuelve una promesa que resuelve con un ArrayBuffer.

Especificaciones

Especificación Estado Comentario
File API Working Draft Definición inicial.

Compatibilidad en Navegadores

BCD tables only load in the browser

Notas de Implementación

Ver también