HTTP Clear-Site-Data заголовок ответа сообщает клиенту, что ему следует удалить все данные просмотра определённых типов (файлы cookie, хранилище, кэш), связанные с запрашиваемым веб-сайтом. Он позволяет веб-разработчикам лучше контролировать данные, которые браузеры хранят для их источников.

Синтаксис

// Single directive
Clear-Site-Data: "cache"

// Multiple directives (comma separated)
Clear-Site-Data: "cache", "cookies"

// Wild card
Clear-Site-Data: "*"

Директивы

"cache"

Сервер сообщает клиенту, что ему следует удалить локально кэшированные данные (кэш браузера, см. кэширование HTTP) для источника URL-адреса ответа. В зависимости от браузера также могут быть удалены предварительно отрисованные страницы, кэш переходов вперёд и назад, кэши скриптов, шейдеров WebGL или подсказки в адресной строке.

"clientHints"

Указывает, что сервер удалит все подсказки клиента (запрошенные с помощью Accept-CH), сохранённые для источника URL-адреса ответа.

Примечание: В браузерах, поддерживающих тип данных "clientHints", подсказки клиента также удаляются при указании типов "cache", "cookies" или "*". Поэтому "clientHints" требуется только тогда, когда ни один из этих других типов не указан.

"cookies"

Сервер сообщает клиенту, что ему следует удалить все файлы cookie для источника URL-адреса ответа. Также удаляются учётные данные HTTP-аутентификации. Это затрагивает весь зарегистрированный домен, включая поддомены. Таким образом, файлы cookie будут удалены как для https://example.com, так и для https://stage.example.com.

"executionContexts"

Сервер сообщает клиенту, что ему следует перезагрузить все контексты просмотра для источника ответа (Location.reload).

"prefetchCache"

Используется для удаления предварительных загрузок правил спекулятивной загрузки, область действия которых ограничена источником страницы-источника.

"prerenderCache"

Используется для удаления предварительно отрисованных страниц правил спекулятивной загрузки, область действия которых ограничена источником страницы-источника.

"storage"

Сервер сообщает клиенту, что ему следует удалить все данные DOM-хранилища для источника URL-адреса ответа. Сюда входят такие механизмы хранения, как:

• localStorage (выполняется localStorage.clear),
• sessionStorage (выполняется sessionStorage.clear),
• IndexedDB (для каждой базы данных выполняется IDBFactory.deleteDatabase),
• регистрации сервис-воркеров (для каждой регистрации сервис-воркера выполняется ServiceWorkerRegistration.unregister),
• базы данных Web SQL (устаревшая технология),
• данные FileSystem API,
• данные плагинов (Flash через NPP_ClearSiteData).

"*" (подстановочный знак)

Сервер сообщает клиенту, что ему следует удалить все типы данных для источника ответа. Если в будущих версиях этого заголовка появятся новые типы данных, они также будут охвачены этой директивой.

Примеры

Выход с веб-сайта

Если пользователь выходит с вашего веб-сайта или из вашего сервиса, может потребоваться удалить локально сохранённые данные, включая предварительно загруженное или предварительно отрисованное содержимое для спекулятивных переходов. Для этого добавьте заголовок Clear-Site-Data на страницу, подтверждающую успешный выход с сайта (например, https://example.com/logout):

Clear-Site-Data: "cache", "cookies", "storage", "executionContexts", "prefetchCache", "prerenderCache"

Удаление файлов cookie

Если этот заголовок передан в ответе для https://example.com/clear-cookies, будут удалены все файлы cookie для того же домена https://example.com и любых его поддоменов (например, https://stage.example.com и т. д.).

Clear-Site-Data: "cookies"

Удаление спекулятивных загрузок

Если этот заголовок передан в ответе для https://example.com/change-state.json, все предварительно отрисованные страницы спекулятивных переходов для того же домена https://example.com и любых его поддоменов (например, https://stage.example.com) будут удалены.

Clear-Site-Data: "prerenderCache"

Чтобы удалить и предварительные загрузки, и предварительно отрисованные страницы, необходимо отправить обе директивы: prefetchCache и prerenderCache.

Clear-Site-Data: "prefetchCache", "prerenderCache"

В некоторых случаях целесообразно удалить только один из этих типов данных или оба.

Например, приложение с клиентской отрисовкой, которое загружает данные с помощью JavaScript, может использовать prerenderCache при изменении состояния, чтобы удалить предварительно отрисованные страницы, но сохранить предварительно загруженный HTML для использования при отрисовке страницы (или её повторной предварительной отрисовке).

С другой стороны, если предварительно загруженный HTML-документ содержит устаревшие данные, но соответствующая предварительно отрисованная страница настроена на обновление данных при отображении, возможно, не потребуется использовать prerenderCache, но, скорее всего, понадобится директива prefetchCache, чтобы устаревший HTML не использовался при последующей предварительной отрисовке.

Наконец, если предварительно загруженный HTML-документ содержит устаревшие данные и при этом устаревшее содержимое предварительно отрисованных страниц не обновляется, лучше всего указать обе директивы: prefetchCache и prerenderCache.

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

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

См. также

• Cache-Control