Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

CKTIS / HTML

download: solicitar el guardado de un recurso

Sugiere un nombre sin asumir control de la política de descarga.

Versión: HTML Living Standard

Sintaxis

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

En un ancla o enlace de mapa de imagen, download indica intención de descargar en lugar de navegar. Su valor opcional propone un nombre de archivo. El navegador puede sanearlo o usar información del servidor, y la política del usuario sigue influyendo. No concede escritura arbitraria en el sistema de archivos.

Los recursos del mismo origen y las URL blob locales son el caso directo. Las descargas entre orígenes requieren cooperación adecuada del servidor, incluido el tratamiento como adjunto; el atributo solo no permite forzarlas. Libera las URL temporales cuando dejen de hacer falta, no antes de que la descarga las use.

El ejemplo crea un pequeño blob textual y un enlace. Un clic real produce una descarga completada con nombre sugerido y bytes exactos. La página solo informa de la solicitud; el test del navegador confirma por separado su finalización.

Ejemplos

<!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

El archivo es texto de prueba generado, no uno leído del ordenador del usuario.

Fuentes