Clear-Site-Data

O cabeçalho HTTP Clear-Site-Data limpa os dados de navegação (cookies, armazenamento, cache) associados com o site requisitado. Ele permite desenvolvedores web terem maior controle sobre os dados armazenados localmente pelo navegador para suas origens.

Tipo de cabeçalho Response header
Forbidden header name não

Sintaxe

O cabeçalho Clear-Site-Data aceita uma ou mais diretivas. Se todos os dados devem ser limpos, a diretiva coringa ("*") pode ser usada.

// Diretiva única
Clear-Site-Data: "cache"

// Múltiplas diretivas (separado por vírgula)
Clear-Site-Data: "cache", "cookies"

// Coringa
Clear-Site-Data: "*"

Diretivas

Todas as diretivas devem estar de acordo com a gramática de cadeia de caracteres com as aspas. A diretiva que não inclui aspas duplas é inválida.

"cache"
Indica que o servidor quer remover localmente os dados cacheados (i.e. o cache do navegador, veja HTTP caching) para a URL de origem da resposta. Dependendo do navegador, essa diretiva pode acabar apagando outras coisas como páginas pré-renderizadas, scripts armazenados, shaders WebGL ou sugestões na barra de endereço.
"cookies"
Indica que o servidor quer remover todos os cookies da URL de origem da resposta. Credenciais de autenticação HTTP também são limpas. Isso afeta o registro inteiro do domínio, incluindo subdomínios. Então, https://example.com também como https://stage.example.com, terão seus cookies limpos.
"storage"
Indica que o servidor quer remover todo o armezenamento DOM para a URL de origem da resposta. Isso incluí mecanismos de armazenamento como:
"executionContexts"
Indica que o servidor quer recarregar todos os contextos do navegador da origem da resposta (Location.reload).
"*" (coringa)
Indica que o servidor quer limpar todos os tipos de dados da origem da resposta. Se mais tipos de dados forem adicionados nesse cabeçalho, eles também serão cobertos.

Exemplos

Deslogar de um site

Se um usuário se desloga de um site ou serviço, você talvez queira remover dados armazenados localmente. Você pode atingir isso adicionando o cabeçalho Clear-Site-Data quando enviando a página confirmando o desligamento da autenticação da pessoa do site foi feito com sucesso (https://example.com/logout, por exemplo):

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

Limpando cookies

Se o cabeçalho é entregue com a resposta em https://example.com/clear-cookies, todos os cookies no mesmo domínio e qualquer subdomínio (como https://stage.example.com, etc), serão limpos.

Clear-Site-Data: "cookies"

Especificações

Especificação Status Título
Clear Site Data Working Draft Initial definition.

Compatibilidade de navegador

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
Clear-Site-Data
Experimental
Chrome Full support 61Edge ? Firefox Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE ? Opera Full support 48Safari ? WebView Android Full support 61Chrome Android Full support 61Firefox Android Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Full support 45Safari iOS ? Samsung Internet Android Full support 8.0
"cache"
Experimental
Chrome Full support 61Edge ? Firefox Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE ? Opera Full support 48Safari ? WebView Android Full support 61Chrome Android Full support 61Firefox Android Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Full support 45Safari iOS ? Samsung Internet Android Full support 8.0
"cookies"
Experimental
Chrome Full support 61Edge ? Firefox Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE ? Opera Full support 48Safari ? WebView Android Full support 61Chrome Android Full support 61Firefox Android Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Full support 45Safari iOS ? Samsung Internet Android Full support 8.0
"executionContexts"
Experimental
Chrome No support No
Notes
No support No
Notes
Notes See bug 898503.
Edge ? Firefox No support 63 — 68
No support 63 — 68
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE ? Opera No support NoSafari ? WebView Android No support NoChrome Android No support NoFirefox Android No support 63 — 68
No support 63 — 68
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android No support NoSafari iOS ? Samsung Internet Android Full support 8.0
"storage"
Experimental
Chrome Full support 61Edge ? Firefox Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
IE ? Opera Full support 48Safari ? WebView Android Full support 61Chrome Android Full support 61Firefox Android Full support 63
Full support 63
Full support 62
Disabled
Disabled From version 62: this feature is behind the dom.clearSiteData.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.
Opera Android Full support 45Safari iOS ? Samsung Internet Android Full support 8.0

Legend

Full support  
Full support
No support  
No support
Compatibility unknown  
Compatibility unknown
Experimental. Expect behavior to change in the future.
Experimental. Expect behavior to change in the future.
See implementation notes.
See implementation notes.
User must explicitly enable this feature.
User must explicitly enable this feature.

Veja também