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.

Blob File

Constructor

File()

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 Obsoleto 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 Non-standard 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 MIMEdel 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

Specification
File API
# file-section

Compatibilidad con navegadores

BCD tables only load in the browser

Ver también