Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

CKTIS / HTML

download : demander l’enregistrement d’une ressource

Suggérez un nom sans prétendre contrôler la politique de téléchargement.

Version : HTML Living Standard

Syntaxe

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

Sur une ancre ou un lien de carte d’image, download indique un téléchargement souhaité plutôt qu’une navigation. Sa valeur facultative propose un nom de fichier. Le navigateur peut le nettoyer ou utiliser les informations serveur ; la politique utilisateur reste applicable. Cela n’accorde aucun droit d’écriture arbitraire sur le système de fichiers.

Les ressources de même origine et les URL blob locales sont le cas simple. Un téléchargement interorigine exige une coopération serveur adaptée, notamment le traitement en pièce jointe ; l’attribut seul ne permet pas de l’imposer. Libérez une URL d’objet temporaire quand elle n’est plus nécessaire, pas avant son utilisation.

L’exemple crée un petit blob textuel et son lien. Un vrai clic produit un téléchargement terminé avec le nom proposé et les octets attendus. La page ne signale que la demande ; l’achèvement est confirmé séparément par le test navigateur.

Exemples

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

Résultat

downloadRequested=true

Le fichier est du texte de test généré, pas un fichier lu sur l’ordinateur utilisateur.

Sources