En-tte Clear-Site-Data

Syntaxe

// Directive unique
Clear-Site-Data: "cache"

// Directives multiples (spares par des virgules)
Clear-Site-Data: "cache", "cookies"

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

Directives

"cache"

Le serveur signale que le client doit supprimer les donnes mises en cache localement (le cache du navigateur, voir HTTP caching) pour l'origine de l'URL de la rponse. Selon le navigateur, cela peut galement supprimer des lments tels que des pages pr-rendues, cache arrire-avant, des caches de scripts, des caches de shaders WebGL ou des suggestions de la barre d'adresse.

"clientHints"

Indique que le serveur supprimera toutes les indications client (demandes via Accept-CH) stockes pour l'origine de l'URL de la rponse.

Note : Dans les navigateurs qui prennent en charge le type de donnes "clientHints", les indications client sont galement effaces lorsque les types "cache", "cookies" ou "*" sont dfinis. "clientHints" n'est donc ncessaire que lorsque aucun de ces autres types n'est dfini.

"cookies"

Le serveur signale que le client doit supprimer tous les cookies pour l'origine de l'URL de la rponse. Les identifiants d'authentification HTTP sont galement effacs. Cela affecte l'ensemble du domaine enregistr, y compris les sous-domaines. Ainsi, https://example.com ainsi que https://stage.example.com, auront leurs cookies supprims.

"executionContexts"

Le serveur signale que le client doit recharger tous les contextes de navigation pour l'origine de l'URL de la rponse (Location.reload).

"prefetchCache"

Utilis pour effacer les prchargements des rgles spculatives qui sont limites l'origine du rfrent.

"prerenderCache"

Utilis pour effacer les pages pr-rendues des rgles spculatives qui sont limites l'origine du rfrent.

"storage"

Le serveur signale que le client doit supprimer tout le stockage DOM pour l'origine de l'URL de la rponse. Cela inclut les mcanismes de stockage suivants :

• localStorage (excute localStorage.clear),
• sessionStorage (excute sessionStorage.clear),
• IndexedDB (pour chaque base de donnes excuter IDBFactory.deleteDatabase),
• Enregistrements de service worker (pour chaque enregistrement de service worker, excuter ServiceWorkerRegistration.unregister),
• Bases de donnes Web SQL (obsoltes),
• Donnes de l'API File and Directory Entries,
• Donnes de plugin (Flash via NPP_ClearSiteData (angl.)).

"*" (joker)

Le serveur signale que le client doit supprimer tous les types de donnes pour l'origine de l'URL de la rponse. Si de nouveaux types de donnes sont ajouts dans de futures versions de cet en-tte, ils seront galement couverts.

Exemples

Se dconnecter d'un site

Si une utilisateurice se dconnecte de votre site ou service, vous pouvez souhaiter supprimer les donnes stockes localement, y compris tout contenu prcharg ou prrendu pour des navigations spcules. Pour ce faire, ajoutez l'en-tte Clear-Site-Data la page qui confirme que la dconnexion du site a t effectue avec succs (https://example.com/logout, par exemple) :

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

Suppression des cookies

Si cet en-tte est renvoy dans la rponse https://example.com/clear-cookies, tous les cookies du mme domaine https://example.com et de ses sous-domaines (par exemple https://stage.example.com) seront supprims.

Clear-Site-Data: "cookies"

Suppression des spculations

Si cet entte est renvoy dans la rponse https://example.com/change-state.json, tous les prrendus des navigations spcules sur le mme domaine https://example.com et ses sousdomaines (par exemple https://stage.example.com) seront supprims.

Clear-Site-Data: "prerenderCache"

Pour effacer la fois les spculations de prchargement et de prrendu, envoyez simultanment prefetchCache et prerenderCache :

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

Il existe des cas o il est appropri d'effacer l'un ou l'autre, ou les deux.

Par exemple, une application rendue ct client qui rcupre des donnes via JavaScript peut utiliser prerenderCache lors d'un changement d'tat pour supprimer les pages prrendues, tout en conservant le HTML prcharg pour l'utiliser lorsque la page est rendue (ou prrendue de nouveau).

En revanche, si le document HTML prcharg contient des donnes obsoltes mais que la page prrendue correspondante est conue pour actualiser les donnes lorsqu'elle est affiche, vous n'aurez peuttre pas besoin d'utiliser prerenderCache mais souhaiterez probablement utiliser la directive prefetchCache : ainsi, le HTML obsolte ne sera pas utilis lors d'un futur prrendu.

Enfin, si le document HTML prcharg contient des donnes obsoltes et que les pages prrendues ne rafrachissent pas non plus leur contenu, il est prfrable de spcifier la fois prefetchCache et prerenderCache.

Spcifications

Compatibilit des navigateurs

Voir aussi

• L'en-tte HTTP Cache-Control