Path: blob/main/files/en-us/web/http/headers/cross-origin-opener-policy/index.md
6581 views
------{{HTTPSidebar}}
The HTTP Cross-Origin-Opener-Policy (COOP) response header allows you to ensure a top-level document does not share a browsing context group with cross-origin documents.
COOP will process-isolate your document and potential attackers can't access your global object if they were to open it in a popup, preventing a set of cross-origin attacks dubbed XS-Leaks.
If a cross-origin document with COOP is opened in a new window, the opening document will not have a reference to it, and the window.opener property of the new window will be null. This allows you to have more control over references to a window than rel=noopener, which only affects outgoing navigations.
| Header type | {{Glossary("Response header")}} |
|---|---|
| {{Glossary("Forbidden header name")}} | no |
Syntax
Directives
unsafe-none: This is the default value. Allows the document to be added to its opener's browsing context group unless the opener itself has a COOP of
same-originorsame-origin-allow-popups.
same-origin-allow-popups: Retains references to newly opened windows or tabs that either don't set COOP or that opt out of isolation by setting a COOP of
unsafe-none.
same-origin: Isolates the browsing context exclusively to same-origin documents. Cross-origin documents are not loaded in the same browsing context.
Examples
Certain features depend on cross-origin isolation
Certain features like {{jsxref("SharedArrayBuffer")}} objects or {{domxref("Performance.now()")}} with unthrottled timers are only available if your document has a COOP header with the value same-origin set.
See also the {{HTTPHeader("Cross-Origin-Embedder-Policy")}} header which you'll need to set to require-corp or credentialless as well.
To check if cross-origin isolation has been successful, you can test against the crossOriginIsolated property available to window and worker contexts:
Specifications
{{Specifications}}
Browser compatibility
{{Compat}}
See also
{{httpheader("Cross-Origin-Embedder-Policy")}}