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.

{{page("/pt-BR/docs/Web/API/Blob","Properties")}}

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

Specification
File API
# file-section

Compatibilidade com os Navegadores

BCD tables only load in the browser

Veja também