File
Sumário
A interface File provê informações sobre arquivos e permite ao JavaScript a acessar seu conteúdo.
São geralmente recuperados a partir de um objeto FileList que é retornado como resultado da seleção, pelo usuário, de arquivos através do elemento <input>, a partir do objeto DataTransfer utilizado em operações de arrastar e soltar, ou a partir da API mozGetAsFile() em um HTMLCanvasElement (en-US). Em Gecko, códigos com privilégiios podem criar objetos File representando qualquer arquivo local sem a intereção do usuário (veja Implementation notes para mais informações.)
Um objeto File é um tipo específico de Blob, e podem ser utilizados em qualquer contexto que um Blob pode. Em particular, FileReader, URL.createObjectURL(), createImageBitmap() (en-US), e XMLHttpRequest.send() aceitam ambos, Blobs e Files.
Veja Using files from web applications (en-US) (usando arquivos através de uma aplicação web) para mais informações e exemplos.
A referência ao arquivo pode ser salva quando o formulário é submetido enquanto o usuário está offline, de forma que os dados possam ser recuperados e enviados quando a conexão com a internet for reestabelecida,
Propriedades
File.lastModifiedDate(en-US) Somente leitura-
A Data da última modificação do arquivo referenciado pelo objeto
File. File.name(en-US) Somente leitura-
O nome do arquivo referenciado pelo objeto
File. File.fileName(en-US) Non-standard Somente leitura-
O nome do arquivo referenciado pelo objeto
File. File.fileSize(en-US) Non-standard Somente leitura-
O tamanho do arquivo referenciado, em bytes.
A interface File herda as propriedades da interface Blob.
Métodos
File.getAsBinary()Non-standard-
Retorna uma string contendo os dados do arquivo em formato binário.
File.getAsDataURL()Non-standard-
Uma string contendo os dados do arquivo codificados como
data:URL. File.getAsText(string encoding)Non-standard-
Retorna o conteúdo do arquivo como uma string em que os dados do arquivo são interpretados como texto, usando a codificação passada por parâmetro.
Especificações
| Especificação | Status | Comentários |
|---|---|---|
| File API | Rascunho atual | Definição Inicial. |
Compatibilidade com os Navegadores
BCD tables only load in the browser