Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / HTML

download: pedir a gravação de um recurso

Sugira um nome sem assumir controlo da política de transferências.

Versão: HTML Living Standard

Sintaxe

<a href="..." download="note.txt">Download</a>

Numa âncora ou ligação de mapa de imagem, download indica intenção de transferir em vez de navegar. O valor opcional sugere um nome de ficheiro. O navegador pode ajustá-lo ou usar informações do servidor, e as políticas do utilizador continuam a influenciar. Não concede escrita arbitrária no sistema de ficheiros.

Recursos da mesma origem e URL blob locais são o caso simples. Transferências entre origens exigem colaboração adequada do servidor, incluindo tratamento como anexo; o atributo sozinho não as força. Liberte URL temporários quando deixarem de ser necessários, não antes de a transferência os usar.

O exemplo cria um pequeno blob textual e uma ligação. Um clique real produz uma transferência concluída com nome sugerido e bytes exatos. A página apenas informa do pedido; o teste do navegador confirma o fim separadamente.

Exemplos

<!doctype html><meta charset="utf-8">
<a id="download" download="note.txt">Download local text</a><output id="result"></output><script>
const link = document.querySelector('#download');
const url = URL.createObjectURL(new Blob(['Local example.\n'], { type: 'text/plain' }));
link.href = url;
link.addEventListener('click', () => { document.querySelector('#result').textContent = 'downloadRequested=true'; });
window.addEventListener('pagehide', () => URL.revokeObjectURL(url), { once: true });
</script>

Resultado

downloadRequested=true

O ficheiro é texto de teste gerado, não um ficheiro lido do computador do utilizador.

Fontes