WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

download: Speichern einer verlinkten Ressource anfordern

Schlagen Sie einen Dateinamen vor, ohne Browserregeln kontrollieren zu wollen.

Version: HTML Living Standard

Syntax

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

Auf einem Anker oder Image-Map-Link zeigt download einen gewünschten Download statt normaler Navigation an. Der optionale Wert schlägt einen Dateinamen vor. Der Browser kann ihn bereinigen oder Serverinformationen verwenden; Nutzerrichtlinien können den Vorgang beeinflussen. Das Attribut erlaubt keine beliebigen Dateisystemschreibzugriffe.

Ressourcen desselben Ursprungs und lokal erzeugte Blob-URLs sind der einfache Fall. Ursprungsübergreifende Downloads benötigen passende Servermitwirkung einschließlich Anhangbehandlung; das Attribut allein erzwingt sie nicht. Geben Sie temporäre Objekt-URLs erst frei, wenn sie nicht mehr gebraucht werden, nicht bevor der Download sie nutzen kann.

Das Beispiel erzeugt einen kleinen Text-Blob und einen Downloadlink. Ein echter Klick führt zu einem abgeschlossenen Download mit vorgeschlagenem Namen und genau erwarteten Bytes. Die Seite meldet nur die Anforderung; der Browsertest bestätigt den Abschluss unabhängig.

Beispiele

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

Ergebnis

downloadRequested=true

Die Datei ist erzeugter Testtext, keine vom Nutzerrechner gelesene Datei.

Quellen