Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
HEAD request method
Baseline Widely available
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
DieHEAD HTTP-Methode fordert die Metadaten einer Ressource in Form vonHeaders an, die der Server gesendet hätte, wenn stattdessen dieGET-Methode verwendet worden wäre. Diese Methode kann in Fällen verwendet werden, in denen eine URL möglicherweise einen großen Download erzeugt. Zum Beispiel kann eineHEAD-Anfrage denContent-Length Header lesen, um die Dateigröße zu prüfen, bevor die Datei mit einerGET-Anfrage heruntergeladen wird.
Wenn die Antwort auf eineHEAD-Anfrage zeigt, dass eine zwischengespeicherte URL-Antwort veraltet ist, wird die zwischengespeicherte Kopie ungültig, auch wenn keineGET-Anfrage gestellt wurde.
Warnung:Wenn eine Antwort auf eineHEAD-Anfrage einen Body enthält, muss der Antwort-Body ignoriert werden. AlleRepräsentations-Header, die den fehlerhaften Body beschreiben, gelten als Beschreibung des Antwort-Bodys, den eineGET-Anfrage erhalten hätte.
| Anfrage hat Body | Nein |
|---|---|
| Antwort bei Erfolg hat Body | Nein |
| Sicher | Ja |
| Idempotent | Ja |
| Cacheable | Ja |
| InHTML-Formularen erlaubt | Nein |
Syntax
HEAD <request-target>["?"<query>] HTTP/1.1<request-target>Identifiziert die Zielressource der Anfrage in Kombination mit den im
HostHeader bereitgestellten Informationen. Dies ist ein absoluter Pfad (z.B./path/to/file.html) in Anfragen an einen Ursprung-Server und eine absolute URL in Anfragen an Proxies (z.B.http://www.example.com/path/to/file.html).<query>OptionalEin optionaler Abfrage-Komponenten, vorangestellt mit einem Fragezeichen
?. Häufig verwendet, um Identifikationsinformationen in Form vonkey=valuePaaren zu übermitteln.
Beispiele
Erfolgreiches Abrufen von Ressourcen-Metadaten
Der folgendecurl-Befehl erstellt eineHEAD-Anfrage fürexample.com:
curl --head example.comDies entspricht einerGET-Anfrage, außer dass der Server keinen Nachrichten-Body in der Antwort einschließen sollte. Es erstellt eine HTTP-Anfrage, die so aussieht:
HEAD / HTTP/1.1Host: example.comUser-Agent: curl/8.6.0Accept: */*Der Server sendet eine200 OK Antwort zurück, die nur aus Headers besteht. Die Antwort ist effektiv Metadaten, die die Ressource beschreiben, anstatt die Ressource selbst (einigeCaching Header sind in diesem Beispiel aus Gründen der Kürze weggelassen):
HTTP/1.1 200 OKContent-Type: text/html; charset=UTF-8Date: Wed, 04 Sep 2024 10:33:11 GMTContent-Length: 1234567Spezifikationen
| Specification |
|---|
| HTTP Semantics # HEAD |