File

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since January 2020.

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 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.lastModifiedRead 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 No estándar Read only

Retorna la ruta relativa de la URL del File.

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

File.sizeRead only

Retorna el tamaño del archivo en bytes.

File.typeRead 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 fuente Blob.

Blob.stream()

Transforma el archivo File en un ReadableStream que puede ser usado para leer el contenido de File.

Blob.text()

Transforma el archivo File en una corriente (stream) para leerse hasta completarse. Retorna una promesa que se resuelve con un USVString (texto).

Blob.arrayBuffer()

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

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
File
File() constructor
lastModified
lastModifiedDate
DeprecatedNon-standard
name
webkitRelativePath

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
Non-standard. Check cross-browser support before using.
Deprecated. Not for use in new websites.
See implementation notes.
Has more compatibility info.

Ver también