Clear-Site-Data - HTTP

在此页

句法
指令
范例
规范
浏览器兼容性
另请参阅
相关话题

Clear-Site-Data header clears browsing data (cookies, storage, cache) associated with the requesting website. It allows web developers to have more control over the data stored locally by a browser for their origins.

Header type	Response header
Forbidden header name	no

句法

Clear-Site-Data header accepts one or more directives. If all types of data should be cleared, the wildcard directive ( "*" ) can be used.

// Single directive
Clear-Site-Data: "cache"
// Multiple directives (comma separated)
Clear-Site-Data: "cache", "cookies"
// Wild card
Clear-Site-Data: "*"

指令

All directives must comply with the quoted-string grammar . A directive that does not include the double quotes is invalid.

"cache"

Indicates that the server wishes to remove locally cached data (i.e. the browser cache, see HTTP caching ) for the origin of the response URL. Depending on the browser, this might also clear out things like pre-rendered pages, script caches, WebGL shader caches, or address bar suggestions.

"cookies"

Indicates that the server wishes to remove all cookies for the origin of the response URL. HTTP authentication credentials are also cleared out. This affects the entire registered domain, including subdomains. So https://example.com as well as https://stage.example.com, will have cookies cleared.

"storage"

Indicates that the server wishes to remove all DOM storage for the origin of the response URL. This includes storage mechanisms such as:

localStorage (executes localStorage.clear ),
sessionStorage (executes sessionStorage.clear ),
IndexedDB (for each database execute IDBFactory.deleteDatabase ),
Service worker registrations (for each service worker registration, execute ServiceWorkerRegistration.unregister ),
AppCache,
WebSQL databases,
FileSystem API data ,
Plugin data (Flash via NPP_ClearSiteData ).

"executionContexts"

Indicates that the server wishes to reload all browsing contexts for the origin of the response (


Location.reload

"*" (wildcard)

Indicates that the server wishes to clear all types of data for the origin of the response. If more data types are added in future versions of this header, they will also be covered by it.

范例

Sign out of web site

If a user signs out of your website or service, you might want to remove locally stored data. You can achieve that by adding the Clear-Site-Data header when sending the page confirming that logging out from the site has been accomplished successfully (https://example.com/logout, for example):

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

Clearing cookies

If this header is delivered with the response at https://example.com/clear-cookies, all cookies on the same domain https://example.com and any subdomains (like https://stage.example.com, etc), will be cleared out.

Clear-Site-Data: "cookies"

规范

规范	状态	Title
Clear Site Data	工作草案	初始定义。

浏览器兼容性

The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request. 更新 GitHub 上的兼容性数据

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	Android webview	Chrome for Android	Firefox for Android	Opera for Android	Safari on iOS	Samsung Internet
`Clear-Site-Data` Experimental	Chrome 完整支持 61	Edge 完整支持 ≤79	Firefox 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	IE ?	Opera 完整支持 48	Safari ?	WebView Android 完整支持 61	Chrome Android 完整支持 61	Firefox Android 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 完整支持 45	Safari iOS ?	Samsung Internet Android 完整支持 8.0
`"cache"` Experimental	Chrome 完整支持 61	Edge 完整支持 ≤79	Firefox 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	IE ?	Opera 完整支持 48	Safari ?	WebView Android 完整支持 61	Chrome Android 完整支持 61	Firefox Android 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 完整支持 45	Safari iOS ?	Samsung Internet Android 完整支持 8.0
`"cookies"` Experimental	Chrome 完整支持 61	Edge 完整支持 ≤79	Firefox 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	IE ?	Opera 完整支持 48	Safari ?	WebView Android 完整支持 61	Chrome Android 完整支持 61	Firefox Android 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 完整支持 45	Safari iOS ?	Samsung Internet Android 完整支持 8.0
`"executionContexts"` Experimental	Chrome 不支持 No 注意事项不支持 No 注意事项注意事项见 bug 898503 .	Edge 不支持 No 注意事项不支持 No 注意事项注意事项见 bug 898503 .	Firefox 不支持 63 — 68 不支持 63 — 68 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	IE ?	Opera 不支持 No	Safari ?	WebView Android 不支持 No	Chrome Android 不支持 No	Firefox Android 不支持 63 — 68 不支持 63 — 68 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 不支持 No	Safari iOS ?	Samsung Internet Android 完整支持 8.0
`"storage"` Experimental	Chrome 完整支持 61	Edge 完整支持 ≤79	Firefox 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	IE ?	Opera 完整支持 48	Safari ?	WebView Android 完整支持 61	Chrome Android 完整支持 61	Firefox Android 完整支持 63 完整支持 63 完整支持 62 Disabled Disabled ). To change preferences in Firefox, visit	Opera Android 完整支持 45	Safari iOS ?	Samsung Internet Android 完整支持 8.0

图例

完整支持
不支持
兼容性未知 ?
实验。期望将来行为有所改变。
见实现注意事项。
用户必须明确启用此特征。

另请参阅

Cache-Control

元数据

最后修改： Aug 9, 2020

在此页

句法

指令

范例

Sign out of web site

Clearing cookies

规范

浏览器兼容性

图例

另请参阅

相关话题