Accept

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

HTTP заголовок запроса Accept указывает, какие типы контента, выраженные как MIME типы, клиент может понять. Используя согласование контента, сервер затем выбирает одно из предложений, использует его и информирует клиента о своём выборе с помощью заголовка ответа Content-Type. Браузеры задают адекватные значения для этого заголовка в зависимости от контекста, в котором выполняется запрос: при получении таблицы стилей CSS для запроса задаётся другое значение, чем при получении изображения, видео или скрипта.

Тип заголовка Request header
Запрещённое имя заголовка нет
CORS-safelisted request-header yes, with the additional restriction that values can't contain a CORS-unsafe request header byte: 0x00-0x1F (except 0x09 (HT)), "():<>?@[\]{}, and 0x7F (DEL).

Синтаксис

Accept: <MIME_type>/<MIME_subtype>
Accept: <MIME_type>/*
Accept: */*

// Несколько типов, дополненных синтаксисом значений качества:
Accept: text/html, application/xhtml+xml, application/xml;q=0.9, */*;q=0.8

Директивы

<MIME_type>/<MIME_subtype>

Один точный MIME-тип, например text/html.

<MIME_type>/*

MIME тип без какого-либо подтипа. image/* будет соответствовать типам image/png, image/svg, image/gif и любым другим типам изображений.

*/*

Любой MIME type

;q= (q-factor weighting)

Любое используемое значение помещается в порядке приоритета, заданным с использованием относительного значения качества, которое называется весом.

Примеры

Accept: text/html

Accept: image/*

Accept: text/html, application/xhtml+xml, application/xml;q=0.9, */*;q=0.8

Спецификации

Характеристика Название
RFC 7231, раздел 5.3.2: Accept Hypertext Transfer Protocol (HTTP/1.1): Semantics and Context

Совместимость с браузерами

BCD tables only load in the browser

Смотрите также