Location
Заголовок відповіді Location
вказує URL-адресу для перенаправлення сторінки. Він надає лише значення, коли подається відповідь зі статусом 3xx (перенаправлення) або 201 (створений).
У випадках перенаправлення, метод HTTP, який використовується для внесення нового запиту на вибір сторінки, на яку позначається Location
, залежить від оригінального методу та виду перенаправлення:
- Якщо відповіді 303 (en-US) (Див.також) завжди призводять до використання методу
GET
, 307 (en-US) (Тимчасове перенаправлення) та 308 (en-US) (Постійне перенаправлення) не змінює метод, використаний у вихідному запиті; - 301 (en-US) (Постійне перенаправлення) і 302 (en-US) (Знайдено) не змінюють метод більшу частину часу, хоча старі користувачі-агенти можуть це робити (так що ви, в основному, не відомо).
Усі відповіді з одним із цих кодів стану надсилають заголовок Location
.
У випадках створення ресурсу, сервер вказує URL-адресу новоствореного ресурсу.
Location
та Content-Location (en-US) є різними: Location
вказує на ціль перенаправлення (або URL новоствореного ресурсу), тоді як Content-Location (en-US) вказує на пряму URL-адресу, яка використовується для доступу до ресурсу, коли відбувається узгодження вмісту, без необхідності подальшого узгодження вмісту. Location
є заголовком, пов'язаним з відповіддю, тоді як Content-Location (en-US) асоціюється з повернутим об'єктом.
Header type | Response header |
---|---|
Forbidden header name | no |
Синтаксис
Location: <url>
Директиви
- <url>
- Відносна (до URL-адреси запиту) або абсолютна URL-адреса.
Приклади
Location: /index.html
Специфікації
Specification | Title |
---|---|
RFC 7231, section 7.1.2: Location | Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content |
Сумісність з браузерами
BCD tables only load in the browser
The compatibility table in this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
See also
- Content-Location (en-US)
- Status of responses including a
Location
header:201
, 301 (en-US), 302 (en-US), 303 (en-US), 307 (en-US), 308 (en-US).