Данные веб-сайта
Данные веб-сайта
Безопасный контекст: Эта функция доступна только в безопасных контекстах (HTTPS), в некоторых или во всех поддерживающих браузерах.
Заголовок Clear-Site-Data очищает данные просмотра (куки, хранилище, кэш), связанные с запрашиваемым веб-сайтом. Он позволяет веб-разработчикам иметь больший контроль над данными, хранящимися клиентом браузера для своих источников.
| Тип заголовка | Заголовок ответа |
|---|---|
| Запрещённое имя заголовка | нет |
Синтаксис
Заголовок Clear-Site-Data принимает одну или несколько директив. Если необходимо очистить все типы данных, можно использовать диревктиву-маску ("*").
// Single directive Clear-Site-Data: "cache" // Multiple directives (comma separated) Clear-Site-Data: "cache", "cookies" // Wild card Clear-Site-Data: "*"
Директивы
Примечание: Все директивы должны соответствовать грамматике строк в кавычках. Директива без кавычек является некорректной.
-
"cache"Экспериментально -
Указывает, что сервер хочет удалить данные, кэшированные локально (кэш браузера, см. кэширование HTTP) для источника URL ответа. В зависимости от браузера, это также может очистить предварительно рендеренные страницы, кэш скриптов, кэш шейдеров WebGL или предложения адресной строки.
-
Указывает, что сервер хочет удалить все куки для источника URL ответа. Также очищаются учетные данные аутентификации HTTP. Это влияет на весь зарегистрированный домен, включая поддомены. Таким образом,
https://example.comа такжеhttps://stage.example.com, будут иметь куки, удаленные. "storage"-
Указывает, что сервер хочет удалить все данные хранилища DOM для источника URL ответа. Это включает механизмы хранения, такие как:
- localStorage (выполняет
localStorage.clear), - sessionStorage (выполняет
sessionStorage.clear), - IndexedDB (для каждой базы данных выполнить
IDBFactory.deleteDatabase), - Регистрации сервисных рабочих (для каждой регистрации сервисного рабочего выполнить
ServiceWorkerRegistration.unregister), - Базы данных Web SQL (устарели),
- Данные API файловой системы,
- Данные плагинов (Flash через
NPP_ClearSiteData).
- localStorage (выполняет
-
"executionContexts"Экспериментально -
Указывает, что сервер хочет перезагрузить все контексты просмотра для источника ответа (
Location.reload). -
"*"(маска) -
Указывает, что сервер хочет очистить все типы данных для источника ответа. Если в будущих версиях этого заголовка будут добавлены новые типы данных, они также будут включены в эту маску.
Примеры
Выход из веб-сайта
Если пользователь выходит из вашего веб-сайта или службы, вы можете удалить локально сохраненные данные. Для этого добавьте заголовок Clear-Site-Data на страницу, которая подтверждает успешное завершение выхода из сайта (https://example.com/logout, например):
Clear-Site-Data: "cache", "cookies", "storage", "executionContexts"
Удаление куки
Если этот заголовок передаётся с ответом в https://example.com/clear-cookies, все куки в том же домене https://example.com и любых поддоменах (например, https://stage.example.com, и т.д.), будут удалены.
Clear-Site-Data: "cookies"
Спецификации
| Спецификация |
|---|
| Очистка данных веб-сайта # заголовок |
Совместимость с браузерами
| Десктопные | Мобильные | |||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Chrome | Edge | Firefox | Internet Explorer | Opera | Safari | WebView Android | Chrome Android | Firefox для Android | Opera Android | Safari на iOS | Samsung Internet | |
Clear-Site-Data |
61 |
≤79 |
63 |
Нет |
48 |
Нет |
61 |
61 |
63 |
45 |
Нет |
8.0 |
cache |
61 |
≤79 |
94
63-94
|
Нет |
48 |
Нет |
61 |
61 |
63-94 |
45 |
Нет |
8.0 |
cookies |
61 |
≤79 |
63 |
Нет |
48 |
Нет |
61 |
61 |
63 |
45 |
Нет |
8.0 |
executionContexts |
Нет
См. ошибку 898503.
|
Нет
См. ошибку 898503.
|
63-68 |
Нет |
Нет
См. ошибку 898503.
|
Нет |
Нет
См. ошибку 898503.
|
Нет
См. ошибку 898503.
|
63-68 |
Нет
См. ошибку 898503.
|
Нет |
8.0 |
secure_context_required |
61 |
≤79 |
63 |
Нет |
48 |
Нет |
61 |
61 |
63 |
45 |
Нет |
8.0 |
storage |
61 |
≤79 |
63 |
Нет |
48 |
Нет |
61 |
61 |
63 |
45 |
Нет |
8.0 |
См. также
© 2005–2022 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Clear-Site-Data