File

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,

File.lastModifiedDate Somente leitura

A Data da última modificação do arquivo referenciado pelo objeto File.

File.name Somente leitura

O nome do arquivo referenciado pelo objeto File.

File.fileName Não padrão Somente leitura

O nome do arquivo referenciado pelo objeto File.

File.fileSize Não padrão Somente leitura

O tamanho do arquivo referenciado, em bytes.

A interface File herda as propriedades da interface Blob.

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.

• Using files from web applications
• Using the DOM File API in chrome code
• FileReader