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
retornado como resultado de un usuario seleccionado archivos por medio de un elemento <input>
, desde las operaciones drag y drop de un objeto DataTransfer
, 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()
, y XMLHttpRequest.send()
aceptan tanto Blob
s y File
s.
Ver Utilizando archivos desde aplicaciones web (Using files from web applications) para más información y ejemplos.
Constructor
File()
-
Retorna un nuevo objeto de tipo
File
.
Propiedades
File.lastModified
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
Date
Date
) de modificación del archivo referenciada por el objetoFile
. File.name
Read 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
implementaBlob
, así que también cuenta con las siguientes propiedades: File.size
Read only-
Retorna el tamaño del archivo en bytes.
File.type
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]]])
-
Retorna un nuevo objeto
Blob
conteniendo la información en el rango especificado de bytes de la fuenteBlob
. Blob.stream()
-
Transforma el archivo
File
en unReadableStream
que puede ser usado para leer el contenido deFile
. Blob.text()
-
Transforma el archivo
File
en una corriente (stream) para leerse hasta completarse. Retorna una promesa que se resuelve con unUSVString
(texto). Blob.arrayBuffer()
-
Transforma el archivo
File
en una corriente y leerlo hasta completarse. Devuelve una promesa que resuelve con unArrayBuffer
.
Especificaciones
Specification |
---|
File API # file-section |
Compatibilidad con navegadores
BCD tables only load in the browser