Skip to content

Commit 9dc8a26

Browse files
committed
[Related Website Sets] Delete RWS guide
Add links to official Chrome document, where appropriate.
1 parent 3944506 commit 9dc8a26

9 files changed

Lines changed: 12 additions & 175 deletions

File tree

files/en-us/_redirects.txt

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -10421,6 +10421,7 @@
1042110421
/en-US/docs/Web/API/StorageQuota/queryInfo /en-US/docs/Web/API/StorageManager
1042210422
/en-US/docs/Web/API/StorageQuota/requestPersistentQuota /en-US/docs/Web/API/StorageManager
1042310423
/en-US/docs/Web/API/StorageQuota/supportedTypes /en-US/docs/Web/API/StorageManager
10424+
/en-US/docs/Web/API/Storage_Access_API/Related_website_sets /en-US/docs/Web/API/Storage_Access_API
1042410425
/en-US/docs/Web/API/StyleSheet.disabled /en-US/docs/Web/API/StyleSheet/disabled
1042510426
/en-US/docs/Web/API/StyleSheet.href /en-US/docs/Web/API/StyleSheet/href
1042610427
/en-US/docs/Web/API/StyleSheet.media /en-US/docs/Web/API/StyleSheet/media

files/en-us/mdn/writing_guidelines/page_structures/banners_and_notices/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -74,4 +74,4 @@ It is important to clarify the current standardization status of such features t
7474
- Adding a "Standards positions" section to the same page as the above banner, as a sub-section of the standard "Specifications" section.
7575

7676
> [!NOTE]
77-
> See [Related Website Sets](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets) for an example of the "Standards positions" section and what it should contain, as well as the landing page banner.
77+
> See [Shared Storage API](/en-US/docs/Web/API/Shared_Storage_API) for an example of the "Standards positions" section and what it should contain, as well as the landing page banner.

files/en-us/web/api/document/index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -281,7 +281,7 @@ _This interface also inherits from the {{DOMxRef("Node")}} and {{DOMxRef("EventT
281281
- {{DOMxRef("Document.requestStorageAccess()")}}
282282
- : Allows a document loaded in a third-party context (i.e., embedded in an {{htmlelement("iframe")}}) to request access to unpartitioned cookies, in cases where user agents by default block access to unpartitioned cookies by sites loaded in a third-party context to improve privacy.
283283
- {{DOMxRef("Document.requestStorageAccessFor()")}} {{deprecated_inline}} {{non-standard_inline}}
284-
- : Allows top-level sites to request third-party cookie access on behalf of embedded content originating from another site in the same [related website set](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets).
284+
- : Allows top-level sites to request third-party cookie access on behalf of embedded content originating from another site in the same [related website set](https://privacysandbox.google.com/cookies/related-website-sets-integration).
285285
- {{domxref("Document.startViewTransition()")}}
286286
- : Starts a new {{domxref("View Transition API", "view transition", "", "nocode")}} and returns a {{domxref("ViewTransition")}} object to represent it.
287287

files/en-us/web/api/document/requeststorageaccessfor/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -11,7 +11,7 @@ browser-compat: api.Document.requestStorageAccessFor
1111

1212
{{APIRef("Storage Access API")}}{{deprecated_header}}{{non-standard_header}}
1313

14-
The **`requestStorageAccessFor()`** method of the {{domxref("Document")}} interface allows top-level sites to request third-party cookie access on behalf of embedded content originating from another site in the same [related website set](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets). It returns a {{jsxref("Promise")}} that resolves if the access was granted, and rejects if access was denied.
14+
The **`requestStorageAccessFor()`** method of the {{domxref("Document")}} interface allows top-level sites to request third-party cookie access on behalf of embedded content originating from another site in the same [related website set](https://privacysandbox.google.com/cookies/related-website-sets-integration). It returns a {{jsxref("Promise")}} that resolves if the access was granted, and rejects if access was denied.
1515

1616
## Syntax
1717

@@ -43,7 +43,7 @@ A {{jsxref("Promise")}} that fulfills with `undefined` if the access to third-pa
4343
- The document is not the top-level document.
4444
- The document has a `null` origin.
4545
- The supplied `requestedOrigin` is [opaque](https://html.spec.whatwg.org/multipage/browsers.html#concept-origin-opaque).
46-
- The top-level and embedded sites are not in the same [related website set](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets).
46+
- The top-level and embedded sites are not in the same [related website set](https://privacysandbox.google.com/cookies/related-website-sets-integration).
4747
- The embedding {{htmlelement("iframe")}} is sandboxed, and the `allow-storage-access-by-user-activation` token is not set.
4848
- Usage is blocked by a {{httpheader("Permissions-Policy/storage-access", "storage-access")}} [Permissions Policy](/en-US/docs/Web/HTTP/Guides/Permissions_Policy).
4949
- Usage is denied by the user agent's permission request to use the API.

files/en-us/web/api/storage_access_api/index.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,7 +67,7 @@ Third party content embedded in an {{htmlelement("iframe")}} that needs to acces
6767
- Safari shows prompts for all embedded content that has not previously received storage access.
6868
- Firefox only prompts users after an origin has requested storage access on more than a threshold number of sites.
6969
- Chrome shows prompts for all embedded content that has not previously received storage access.
70-
It will however automatically grant access and skip prompts if the embedded content and embedding site are part of the same [related website set](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets).
70+
It will however automatically grant access and skip prompts if the embedded content and embedding site are part of the same [related website set](https://privacysandbox.google.com/cookies/related-website-sets-integration).
7171

7272
3. Permission is granted or denied based on whether the content meets all the security requirements — see [Security considerations](#security_considerations) for general requirements, and [Browser-specific variations](#browser-specific_variations) for some browser-specific security requirements.
7373
The {{jsxref("Promise")}}-based nature of `requestStorageAccess()` allows you to run code to handle success and failure cases.
@@ -311,8 +311,8 @@ Documentation for Firefox's new storage access policy for blocking tracking cook
311311
- : New name for {{domxref("Document.hasStorageAccess()")}}.
312312
- {{domxref("Document.requestStorageAccess()")}}
313313
- : Allows content loaded in a third-party context (i.e., embedded in an {{htmlelement("iframe")}}) to request access to third-party cookies and unpartitioned state; returns a {{jsxref("Promise")}} that resolves if the access was granted, and rejects if access was denied.
314-
- {{domxref("Document.requestStorageAccessFor()")}} {{experimental_inline}}
315-
- : A proposed extension to the Storage Access API that allows top-level sites to request third-party cookie access on behalf of embedded content originating from another site in the same [related website set](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets). Returns a {{jsxref("Promise")}} that resolves if the access was granted, and rejects if access was denied.
314+
- {{domxref("Document.requestStorageAccessFor()")}} {{deprecated_inline}}
315+
- : A non-standard deprecated extension to the Storage Access API that allows top-level sites to request third-party cookie access on behalf of embedded content originating from another site in the same [related website set](https://privacysandbox.google.com/cookies/related-website-sets-integration). Returns a {{jsxref("Promise")}} that resolves if the access was granted, and rejects if access was denied.
316316

317317
> [!NOTE]
318318
> User interaction propagates to the promise returned by these methods, allowing the callers to take actions requiring user interaction without requiring a second click. For example, a caller could open a pop-up window from the resolved promise without triggering Firefox's pop-up blocker.

files/en-us/web/api/storage_access_api/related_website_sets/index.md

Lines changed: 0 additions & 163 deletions
This file was deleted.

files/en-us/web/api/storage_access_api/using/index.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -117,15 +117,15 @@ async function handleCookieAccess() {
117117
118118
### Related website sets
119119

120-
The Chrome-only [related website sets](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets) feature can be considered a progressive enhancement mechanism that works alongside the Storage Access API — supporting browsers grant default third-party cookie and unpartitioned state access between websites in the same set. This means not having to go through the usual user permission prompt workflow described above, meaning a more user-friendly experience for users of sites in the set.
120+
The Chrome-only [related website sets](https://privacysandbox.google.com/cookies/related-website-sets-integration) feature can be considered a progressive enhancement mechanism that works alongside the Storage Access API — supporting browsers grant default third-party cookie and unpartitioned state access between websites in the same set. This means not having to go through the usual user permission prompt workflow described above, meaning a more user-friendly experience for users of sites in the set.
121121

122122
## Requesting storage access from the top-level site on behalf of embedded resources
123123

124124
The Storage Access API features above allow an embedded document to request its own third-party cookie access. There is an additional experimental method available, {{domxref("Document.requestStorageAccessFor()")}}, a proposed extension to the Storage Access API that allows top-level sites to request storage access on behalf of specific related origins.
125125

126126
The `requestStorageAccessFor()` method addresses challenges in adopting the Storage Access API on top-level sites that use cross-site images or scripts requiring cookies. It can enable third-party cookie access for cross-site resources directly embedded into the top-level site that are unable to request their own storage access, for example via {{htmlelement("img")}} or {{htmlelement("script")}} elements.
127127

128-
For `requestStorageAccessFor()` to work, both the calling top-level page and the embedded resource it is requesting storage access for need to be part of the same [related website set](/en-US/docs/Web/API/Storage_Access_API/Related_website_sets).
128+
For `requestStorageAccessFor()` to work, both the calling top-level page and the embedded resource it is requesting storage access for need to be part of the same [related website set](#related_website_sets).
129129

130130
Typical usage of `requestStorageAccessFor()` looks like this (this time written in regular promise-style rather than async/await):
131131

0 commit comments

Comments
 (0)