feat: Editorial review for Shared Storage API docs

files/en-us/web/api/sharedstorage/append/index.md

@@ -0,0 +1,62 @@
+---
+title: "SharedStorage: append() method"
+short-title: append()
+slug: Web/API/SharedStorage/append
+page-type: web-api-instance-method
+status:
+  - experimental
+browser-compat: api.SharedStorage.append
+---
+
+{{APIRef("Shared Storage API")}}{{SeeCompatTable}}
+
+The **`append()`** method of the {{domxref("SharedStorage")}} interface appends a string to the value of an existing key-value pair in the current origin's shared storage.
+
+## Syntax
+
+```js-nolint
+append(key, value)
+```
+
+### Parameters
+
+- `key`
+  - : A string representing the key of the key-value pair to which you want to append a value.
+- `value`
+  - : A string that you want to append to the existing value of the key-value pair.
+
+> **Note:** If the specified `key` isn't found in the shared storage, the `append()` operation is equivalent to {{domxref("SharedStorage.set", "set()")}}, that is, a new key-value pair with the specified `key` is added to the shared storage.
+
+### Return value
+
+A {{jsxref("Promise")}} that fulfills with `undefined`.
+
+### Exceptions
+
+- The `Promise` rejects with a {{jsxref("TypeError")}} if:
+  - The appended entry was not successfully stored in the database due to shared storage not being available (for example it is disabled using a browser setting).
+  - `key` and/or `value` exceed the browser-defined maximum length.
+  - The calling site does not have the Shared Storage API included in a successful [privacy sandbox enrollment process](/en-US/docs/Web/Privacy/Privacy_sandbox/Enrollment).
+- In the case of {{domxref("WorkletSharedStorage")}}, the `Promise` rejects with a {{jsxref("TypeError")}} if the worklet module has not been added with {{domxref("Worklet.addModule", "SharedStorageWorklet.addModule()")}}.
+
+> **Note:** In the case of {{domxref("WindowSharedStorage")}}, if the `append()` operation doesn't successfully write to the database for a reason other than shared storage not being available, no error is thrown — the operation still fulfills with `undefined`.
+
+## Examples
+
+```js
+window.sharedStorage
+  .append("integer-list", ",9")
+  .then(console.log("Value appended to integer list"));
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [Shared Storage API](/en-US/docs/Web/API/Shared_Storage_API)

files/en-us/web/api/sharedstorage/clear/index.md

@@ -0,0 +1,54 @@
+---
+title: "SharedStorage: clear() method"
+short-title: clear()
+slug: Web/API/SharedStorage/clear
+page-type: web-api-instance-method
+status:
+  - experimental
+browser-compat: api.SharedStorage.clear
+---
+
+{{APIRef("Shared Storage API")}}{{SeeCompatTable}}
+
+The **`clear()`** method of the {{domxref("SharedStorage")}} interface clears the current origin's shared storage, removing all data from it.
+
+## Syntax
+
+```js-nolint
+clear()
+```
+
+### Parameters
+
+None.
+
+### Return value
+
+A {{jsxref("Promise")}} that fulfills with `undefined`.
+
+### Exceptions
+
+- The `Promise` rejects with a {{jsxref("TypeError")}} if:
+  - The database was not cleared successfully due to shared storage not being available (for example it is disabled using a browser setting).
+  - The calling site does not have the Shared Storage API included in a successful [privacy sandbox enrollment process](/en-US/docs/Web/Privacy/Privacy_sandbox/Enrollment).
+- In the case of {{domxref("WorkletSharedStorage")}}, the `Promise` rejects with a {{jsxref("TypeError")}} if the worklet module has not been added with {{domxref("Worklet.addModule", "SharedStorageWorklet.addModule()")}}.
+
+> **Note:** In the case of {{domxref("WindowSharedStorage")}}, if the `clear()` operation doesn't successfully write to the database for a reason other than shared storage not being available, no error is thrown — the operation still fulfills with `undefined`.
+
+## Examples
+
+```js
+window.sharedStorage.clear().then(console.log("Shared storage cleared"));
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [Shared Storage API](/en-US/docs/Web/API/Shared_Storage_API)

files/en-us/web/api/sharedstorage/delete/index.md

@@ -0,0 +1,61 @@
+---
+title: "SharedStorage: delete() method"
+short-title: delete()
+slug: Web/API/SharedStorage/delete
+page-type: web-api-instance-method
+status:
+  - experimental
+browser-compat: api.SharedStorage.delete
+---
+
+{{APIRef("Shared Storage API")}}{{SeeCompatTable}}
+
+The **`delete()`** method of the {{domxref("SharedStorage")}} interface deletes an existing key-value pair from the current origin's shared storage.
+
+## Syntax
+
+```js-nolint
+delete(key)
+```
+
+### Parameters
+
+- `key`
+  - : A string representing the key of the key-value pair you want to delete.
+
+### Return value
+
+A {{jsxref("Promise")}} that fulfills with `undefined`.
+
+### Exceptions
+
+- The `Promise` rejects with a {{jsxref("TypeError")}} if:
+  - The database was not cleared successfully due to shared storage not being available (for example it is disabled using a browser setting).
+  - `key` exceeds the browser-defined maximum length.
+  - The calling site does not have the Shared Storage API included in a successful [privacy sandbox enrollment process](/en-US/docs/Web/Privacy/Privacy_sandbox/Enrollment).
+- In the case of {{domxref("WorkletSharedStorage")}}, the `Promise` rejects with a {{jsxref("TypeError")}} if:
+  - The worklet module has not been added with {{domxref("Worklet.addModule", "SharedStorageWorklet.addModule()")}}.
+
+> **Note:** If the key-value pair doesn't exist in the shared storage, no error is thrown — the operation still fulfills with `undefined`.
+
+> **Note:** In the case of {{domxref("WindowSharedStorage")}}, if the `delete()` operation doesn't successfully write to the database for a reason other than shared storage not being available, no error is thrown — the operation still fulfills with `undefined`.
+
+## Examples
+
+```js
+window.sharedStorage
+  .delete("ab-testing-group")
+  .then(console.log("Value deleted"));
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [Shared Storage API](/en-US/docs/Web/API/Shared_Storage_API)

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

@@ -0,0 +1,51 @@
+---
+title: SharedStorage
+slug: Web/API/SharedStorage
+page-type: web-api-interface
+status:
+  - experimental
+browser-compat: api.SharedStorage
+---
+
+{{APIRef("Shared Storage API")}}{{SeeCompatTable}}
+
+The **`SharedStorage`** interface of the {{domxref("Shared Storage API", "Shared Storage API", "", "nocode")}} represents the shared storage for a particular origin, defining methods to write data to the shared storage.
+
+`SharedStorage` is the base class for:
+
+- {{domxref("WindowSharedStorage")}}, accessed via {{domxref("Window.sharedStorage")}}.
+- {{domxref("WorkletSharedStorage")}}, accessed via {{domxref("SharedStorageWorkletGlobalScope.sharedStorage")}}.
+
+{{InheritanceDiagram}}
+
+## Instance methods
+
+- {{domxref("SharedStorage.append", "append()")}} {{Experimental_Inline}}
+  - : Appends a string to the value of an existing key-value pair in the current origin's shared storage.
+- {{domxref("SharedStorage.clear", "clear()")}} {{Experimental_Inline}}
+  - : Clears the current origin's shared storage, removing all data from it.
+- {{domxref("SharedStorage.delete", "delete()")}} {{Experimental_Inline}}
+  - : Deletes an existing key-value pair from the current origin's shared storage.
+- {{domxref("SharedStorage.set", "set()")}} {{Experimental_Inline}}
+  - : Stores a new key-value pair in the current origin's shared storage or updates an existing one.
+
+## Examples
+
+```js
+window.sharedStorage
+  .set("ab-testing-group", "0")
+  .then(console.log("Value saved to shared storage"));
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- {{domxref("WindowSharedStorage")}}
+- [Shared Storage API](/en-US/docs/Web/API/Shared_Storage_API)

files/en-us/web/api/sharedstorage/set/index.md

@@ -0,0 +1,67 @@
+---
+title: "SharedStorage: set() method"
+short-title: set()
+slug: Web/API/SharedStorage/set
+page-type: web-api-instance-method
+status:
+  - experimental
+browser-compat: api.SharedStorage.set
+---
+
+{{APIRef("Shared Storage API")}}{{SeeCompatTable}}
+
+The **`set()`** method of the {{domxref("SharedStorage")}} interface either stores a new key-value pair in the current origin's shared storage or updates an existing one.
+
+## Syntax
+
+```js-nolint
+set(key, value)
+set(key, value, options)
+```
+
+### Parameters
+
+- `key`
+  - : A string representing the key in the key-value pair that you want to add or update.
+- `value`
+  - : A string representing the value you want to add or update.
+- `options` {{optional_inline}}
+  - : An options object containing the following properties:
+    - `ignoreIfPresent`
+      - : A boolean value. The value `true` causes the set operation to abort if a key-value pair with the specified `key` already exists. The default value `false` causes the set operation to overwrite the previous value.
+
+### Return value
+
+A {{jsxref("Promise")}} that fulfills with `undefined`.
+
+### Exceptions
+
+- The `Promise` rejects with a {{jsxref("TypeError")}} if:
+  - The created entry was not successfully stored in the database due to shared storage not being available (for example it is disabled using a browser setting).
+  - `key` and/or `value` exceed the browser-defined maximum length.
+  - The calling site does not have the Shared Storage API included in a successful [privacy sandbox enrollment process](/en-US/docs/Web/Privacy/Privacy_sandbox/Enrollment).
+- In the case of {{domxref("WorkletSharedStorage")}}, the `Promise` rejects with a {{jsxref("TypeError")}} if the worklet module has not been added with {{domxref("Worklet.addModule", "SharedStorageWorklet.addModule()")}}.
+
+> **Note:** In the case of {{domxref("WindowSharedStorage")}}, if the `set()` operation doesn't successfully write to the database for a reason other than shared storage not being available, no error is thrown — the operation still fulfills with `undefined`.
+
+## Examples
+
+```js
+window.sharedStorage
+  .set("ab-testing-group", "0", {
+    ignoreIfPresent: true,
+  })
+  .then(console.log("Set operation completed"));
+```
+
+## Specifications
+
+{{Specifications}}
+
+## Browser compatibility
+
+{{Compat}}
+
+## See also
+
+- [Shared Storage API](/en-US/docs/Web/API/Shared_Storage_API)