Spec-Zone.ru › HTTP

Заголовки: Save-Data

Заголовок Save-Data

Ограниченная доступность

Эта функция не входит в Baseline, поскольку не работает в некоторых из наиболее широко используемых браузеров.

Хотите, чтобы эта функция поддерживалась в большем количестве браузеров? Расскажите нам почему.

  • Подробнее
  • Посмотреть полную таблицу совместимости
>

Экспериментальная функция: Это экспериментальная технология
Перед использованием в рабочей среде внимательно изучите таблицу совместимости с браузерами.

HTTP-заголовок Save-Data — это заголовок запроса и сетовая клиентская подсказка, которая указывает на предпочтение клиента в отношении сокращения использования данных. Причинами могут быть высокая стоимость передачи данных, низкая скорость соединения и т. д.

Save-Data — это низкоэнтропийная подсказка, поэтому клиент может отправлять её, даже если сервер не запросил её с помощью заголовка ответа Accept-CH. Кроме того, её следует использовать для сокращения объёма данных, отправляемых клиенту, независимо от значений других клиентских подсказок, указывающих на возможности сети, таких как Downlink и RTT.

Значение On означает, что пользователь явно включил на клиенте режим сокращения использования данных. Получив это значение, серверы могут предоставлять альтернативный контент, чтобы уменьшить объём загружаемых данных: например, изображения и видео меньшего размера, другую разметку и стили, отключённый опрос и автоматические обновления и т. д.

Примечание: Отключение серверной отправки HTTP/2 (RFC 7540, раздел 8.2: серверная отправка) может уменьшить объём загружаемых данных. Обратите внимание, что эта функция больше не поддерживается по умолчанию в большинстве основных браузерных движков.

Тип заголовка Заголовок запроса, Клиентская подсказка
Запрещённый заголовок запроса Нет
Заголовок ответа из списка безопасных для CORS Нет

Синтаксис

Save-Data: <sd-token>

Директивы

<sd-token>

Значение, указывающее, хочет ли клиент включить режим сокращения использования данных. on означает «да», а off (значение по умолчанию) — «нет».

Примеры

>

Использование Save-Data: on

Следующий запрос запрашивает ресурс с заголовком Save-Data, указывающим, что клиент включает режим сокращения использования данных:

GET /image.jpg HTTP/1.1
Host: example.com
Save-Data: on

Сервер отвечает ответом 200, а заголовок Vary указывает, что при создании ответа мог использоваться заголовок Save-Data. Кэшам следует учитывать этот заголовок, чтобы различать ответы:

HTTP/1.1 200 OK
Content-Length: 102832
Vary: Accept-Encoding, Save-Data
Cache-Control: public, max-age=31536000
Content-Type: image/jpeg

[…]

Пропуск Save-Data

В этом случае клиент запрашивает тот же ресурс без заголовка Save-Data:

GET /image.jpg HTTP/1.1
Host: example.com

В ответе сервер предоставляет полную версию содержимого. Заголовок Vary гарантирует, что ответы будут кэшироваться раздельно в зависимости от значения заголовка Save-Data. Это позволяет избежать ситуации, когда из кэша пользователю отправляется изображение более низкого качества после того, как заголовок Save-Data перестал присутствовать (например, после переключения с мобильной сети на Wi-Fi).

HTTP/1.1 200 OK
Content-Length: 481770
Vary: Accept-Encoding, Save-Data
Cache-Control: public, max-age=31536000
Content-Type: image/jpeg

[…]

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

Спецификация
Save Data API>
# save-data-request-header-field>

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

Компьютеры Мобильные устройства
Chrome Edge Firefox Opera Safari Chrome Android Firefox для Android Opera Android Safari на iOS Samsung Internet WebView Android WebView на iOS
Save-Data 49 79 Нет 35 Нет 49 Нет 35 Нет 5.0 49 Нет

См. также

  • Функция CSS @media prefers-reduced-data
  • Заголовок Vary, указывающий, что отдаваемое содержимое зависит от значения Save-Data (см. Кэширование HTTP: Vary)
  • NetworkInformation.saveData
  • Помогите пользователям Save-Data на css-tricks.com
  • Создание быстрых и лёгких приложений с Save-Data — web.dev на web.dev
  • Повышение конфиденциальности пользователей и удобства разработчиков с помощью клиентских подсказок User-Agent (developer.chrome.com)

© 2005–2025 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Reference/Headers/Save-Data

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API