The HTTP Permissions-Policy header unload directive controls whether the current document is allowed to run unload event handlers.
Where a defined policy disallows use of this feature, unload event handlers registered in the document will not run.
unload handlers are unreliable and prevent pages from being stored in the back/forward cache (bfcache). Blocking them lets a page stay eligible for the bfcache, even if third-party scripts in the page add unload handlers. See the usage notes for the unload event for alternatives.
Syntax
Permissions-Policy: unload=<allowlist>;
<allowlist>- : A list of origins for which permission is granted to use the feature. See
Permissions-Policy> Syntax for more details.
- : A list of origins for which permission is granted to use the feature. See
Default policy
In Chrome, the default allowlist for unload is (), which means that unload handlers do not run unless a document opts in. Chrome originally used a default allowlist of *, and changed it gradually.
Examples
Blocking unload handlers
A site wants to make sure that no unload handlers run in its pages or in any of their embedded iframes, so that the pages remain eligible for the bfcache. It can do so by delivering the following HTTP response header:
Permissions-Policy: unload=()
Allowing unload handlers
A site that still depends on unload handlers can allow them to run in its top-level pages by delivering the following HTTP response header:
Permissions-Policy: unload=self
To also allow unload handlers in a cross-origin iframe whose origin is https://example.com, the embedding page must include that origin in its allowlist:
Permissions-Policy: unload=(self "https://example.com")
It must also include an iframe attribute on the <iframe> element:
<iframe src="https://example.com/embed" allow="unload"></iframe>
The document loaded in the iframe must also allow unload handlers, using its own Permissions-Policy: unload=self response header.
Specifications
Browser compatibility
See also
- Permissions-Policy header
- Permissions Policy
- Window/unload_event event
- Deprecating the unload event on developer.chrome.com
来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。
