WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / HTML

enctype: die Kodierung einer Formularübermittlung

Verwenden Sie Multipart für Dateien und überlassen Sie die Trennmarke dem Browser.

Version: HTML Living Standard

Syntax

<form method="post" enctype="multipart/form-data">...</form>

Das Formularattribut enctype wählt die Übermittlungskodierung. Werte sind application/x-www-form-urlencoded, multipart/form-data und text/plain; fehlende oder ungültige Werte ergeben den ersten. Ein absendender Button kann die Einstellung überschreiben. Sie betrifft den Übermittlungsalgorithmus, besonders einen HTTP-POST-Body, und verspricht keinen Multipart-Body bei GET.

Verwenden Sie Multipart für Dateiinhalte. Der Browser erzeugt die Boundary zwischen Teilen; erfinden Sie beim Senden von FormData per JavaScript keinen unpassenden Content-Type-Header. Klartextkodierung ist mehrdeutig und für robuste strukturierte Verarbeitung ungeeignet. Prüfen Sie Namen, Größen und Dateiinhalte auf dem Server.

Die Testseite erzeugt eine kleine Datei und sendet einen echten Multipart-POST. Der lokale Endpunkt prüft Inhaltstyp, Feld, Dateinamen und Bytes. Dies bestätigt die tatsächliche Anfrageübertragung, nicht nur den Attributwert des Formulars.

Beispiele

<!doctype html><meta charset="utf-8">
<form id="form" action="/upload" method="post" enctype="multipart/form-data"><label>Title <input name="title" value="Example"></label><label>File <input id="file" name="document" type="file"></label><button>Send local fixture</button></form>
<script>
// A generated test file, never a file read from the user's device.
const files = new DataTransfer(); files.items.add(new File(['Local file.'], 'note.txt', { type: 'text/plain' }));
document.querySelector('#file').files = files.files;
// The isolated local endpoint validates the actual multipart request and returns its result.
</script>

Ergebnis

multipart=true; filename=note.txt; text=Local file.

Der Upload entsteht im Arbeitsspeicher und geht nur an den isolierten abgefangenen Endpunkt.

Quellen