diff --git a/files/en-us/web/http/headers/cross-origin-opener-policy/index.md b/files/en-us/web/http/headers/cross-origin-opener-policy/index.md index 0d2292c5cc6ead3..b90b521cae958f1 100644 --- a/files/en-us/web/http/headers/cross-origin-opener-policy/index.md +++ b/files/en-us/web/http/headers/cross-origin-opener-policy/index.md @@ -60,22 +60,24 @@ Cross-Origin-Opener-Policy: noopener-allow-popups Similarly, a document with this value will itself open new documents in the same BCG if they also have a COOP value of `unsafe-none` (or no COOP directive). -- `same-origin-allow-popups` - - - : The document permits loading into BCGs that contain only same-origin documents opened in navigations, and documents with a COOP of `unsafe-none` (or no COOP directive) opened with {{domxref("Window.open()")}}. - - The behavior is the largely the same as for the [`same-origin`](#same-origin). - The difference is that a document with this value can, using {{domxref("Window.open()")}}, also open documents into the same BCG if they have a value of `unsafe-none` (or have not specified any value). - In this case it does not matter if the opened document is cross-site or same-site. - - `same-origin` - - : The document permits loading into BCGs that contain only same-origin documents. - This is used to provide cross-origin isolation for a BCG. + - : The document permits loading into BCGs that use COOP and contain only same-origin documents. + This is used to provide [cross-origin isolation](/en-US/docs/Web/API/Window/crossOriginIsolated) for a BCG. A document with this value will be opened into the same BCG as its opener unless it is cross-origin with the opener, or the opener has a COOP value of `unsafe-none`. A document with this value will itself open new documents in the same BCG if they are same-origin and dont have a COOP value of `unsafe-none`. +- `same-origin-allow-popups` + + - : This is the same as the [`same-origin`](#same-origin) directive, except with respect to opening documents with {{domxref("Window.open()")}}. + + A document with this directive can open a document in the same BCG using {{domxref("Window.open()")}} if it has a COOP value of `unsafe-none` or has not specified any value. + In this case it does not matter if the opened document is cross-site or same-site, and the original document remains "cross-origin isolated". + + The directive is used to relax the `same-origin` restriction for integrations where a document needs the benefits of cross-origin isolation but also needs to open and retain a reference to trusted cross-origin documents. + For example, when using a cross-origin service for OAuth or payments. + - `noopener-allow-popups` - : The document must always be loaded into a new BCG.