File
Baseline
Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since julho de 2015.
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. 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(), e XMLHttpRequest.send() aceitam ambos, Blobs e Files.
Veja Using files from web applications (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.lastModifiedDateSomente leitura-
A Data da última modificação do arquivo referenciado pelo objeto
File. File.nameSomente leitura-
O nome do arquivo referenciado pelo objeto
File. File.fileNameNão padrão Somente leitura-
O nome do arquivo referenciado pelo objeto
File. File.fileSizeNão padrão Somente leitura-
O tamanho do arquivo referenciado, em bytes.
A interface File herda as propriedades da interface Blob.
Métodos
File.getAsBinary()Não padrão-
Retorna uma string contendo os dados do arquivo em formato binário.
File.getAsDataURL()Não padrão-
Uma string contendo os dados do arquivo codificados como
data:URL. File.getAsText(string encoding)Não padrão-
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
| Specification |
|---|
| File API # file-section |
Compatibilidade com os Navegadores
Loading…