Path: blob/main/files/en-us/web/http/methods/head/index.md
6532 views
------{{HTTPSidebar}}
The HTTP HEAD method requests the headers that would be returned if the HEAD request's URL was instead requested with the HTTP {{HTTPMethod("GET")}} method. For example, if a URL might produce a large download, a HEAD request could read its {{HTTPHeader("Content-Length")}} header to check the filesize without actually downloading the file.
Warning: A response to a
HEADmethod should not have a body. If it has one anyway, that body must be ignored: any {{glossary("Representation header", "representation headers")}} that might describe the erroneous body are instead assumed to describe the response which a similarGETrequest would have received.
If the response to a HEAD request shows that a cached URL response is now outdated, the cached copy is invalidated even if no GET request was made.
| Request has body | No |
|---|---|
| Successful response has body | No |
| {{Glossary("Safe/HTTP", "Safe")}} | Yes |
| {{Glossary("Idempotent")}} | Yes |
| {{Glossary("Cacheable")}} | Yes |
| Allowed in HTML forms | No |
Syntax
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
{{HTTPMethod("GET")}}