MIME-Typen erklärt: Was Content-Type wirklich bedeutet

Wenn ein Browser eine Datei herunterlädt statt sie anzuzeigen, oder eine Seite ohne ihr Styling lädt, ist der Übeltäter oft ein falscher MIME-Typ. Er gehört zu jenen stillen, unsichtbaren Headern, die erst wichtig werden, wenn sie falsch sind — doch dann brechen sie auf verwirrende Weise.

Diese Anleitung erklärt, was MIME-Typen sind, warum der Content-Type-Header so wichtig ist und wie Sie den richtigen Wert finden.

Was ein MIME-Typ ist

MIME steht für Multipurpose Internet Mail Extensions. Er wurde ursprünglich für E-Mail erfunden, damit eine Nachricht mehr als reinen ASCII-Text transportieren konnte. Der Name blieb, doch die Verwendung ist weit über E-Mail hinausgewachsen.

Ein MIME-Typ folgt einem einfachen Typ/Untertyp-Format — zum Beispiel image/png, application/pdf oder text/html. Der Teil vor dem Schrägstrich ist die Kategorie (image, text, application), der Teil danach der konkrete Untertyp (png, pdf, html). Es gibt außerdem den generischen Binärtyp application/octet-stream, der genutzt wird, wenn der Sender nicht weiß oder nicht sagen will, was die Datei wirklich ist.

MIME-Typen werden von der IANA registriert und gepflegt, die Liste ist also standardisiert.

Warum der Content-Type-Header zählt

Wenn ein Webserver eine Datei zurückgibt, deklariert er ihren Typ im Content-Type-Antwortheader. Der Browser nutzt diesen Header, um zu entscheiden, was mit der Antwort geschieht. Diese eine Entscheidung verursacht eine ganze Familie von Alltagsfehlern:

Kaputte Bilder. Sendet ein Server text/html statt image/png, versucht der Browser, das Bild als Seite zu rendern, und nichts erscheint.
Seiten ohne Styling. Erhält ein Browser eine als text/plain bezeichnete CSS-Datei, weigert er sich, sie als Stylesheet anzuwenden, und die Seite lädt als ungestyltes HTML.
Download statt Anzeige. Wird eine PDF als application/octet-stream gesendet, speichert der Browser sie auf der Festplatte, statt sie zu öffnen.
Abgelehnte Skripte. Ein JavaScript-Modul mit falschem Typ wird nicht ausgeführt.

In jedem Fall ist die Datei in Ordnung — falsch ist das Etikett.

Den richtigen MIME-Typ nachschlagen

Sie brauchen einen MIME-Typ, wann immer Sie einen Header setzen, einen Dateiserver konfigurieren oder ein HTML-accept-Attribut ausfüllen. Am einfachsten schlagen Sie nach der Endung nach:

Eine .webp-Datei → image/webp
Eine .mp4-Datei → video/mp4
Eine .json-Datei → application/json
Eine .svg-Datei → image/svg+xml

Ein Nachschlagewerkzeug lässt Sie nach Endung oder Typ suchen, nach Kategorie durchsuchen und die exakte Zeichenkette kopieren. Entscheidend ist, den echten Inhalt der Datei zu treffen, nicht das, was die Dateiendung nach einer Umbenennung vermuten lässt.

Kurzreferenz

Ein MIME-Typ ist eine Typ/Untertyp-Zeichenkette, z. B. image/png, application/pdf.
Der Content-Type-Antwortheader sagt dem Browser, wie er eine Datei behandeln soll.
Ein falscher Typ verursacht kaputte Bilder, ungestylte Seiten, Downloads statt Anzeige und abgelehnte Skripte.
application/octet-stream ist der generische Binärtyp, wenn der echte Typ unbekannt ist.
Schlagen Sie den Wert nach der Endung nach, um den echten Inhalt der Datei zu treffen.

Erste Schritte

Wenn Sie den korrekten Content-Type-Wert brauchen — für eine API-Antwort, einen Dateiserver oder ein Upload-Formular —, findet ihn der MIME-Typ-Lookup in Sekunden nach Endung oder Typzeichenkette. Und wenn der MIME-Typ stimmt, eine Anfrage aber weiter scheitert, hilft die HTTP-Statusreferenz beim Dekodieren des zurückgegebenen Statuscodes.