SharedStorageWorklet

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig, bevor Sie diese produktiv verwenden.

Das SharedStorageWorklet-Interface der Shared Storage API repräsentiert das geteilte Speicher-Worklet für den aktuellen Ursprung.

SharedStorageWorklet hat keine eigenen Eigenschaften oder Methoden. Es erbt vielmehr die Methode addModule() von der Worklet-Schnittstelle. Diese Methode wird verwendet, um ein Modul hinzuzufügen.

Anders als ein reguläres Worklet:

  • Wenn die aufrufende Stelle die Shared Storage API nicht in einem Privacy Sandbox-Enrolment-Prozess eingeschlossen hat, werden Aufrufe von sharedStorageWorklet.addModule() abgelehnt.
  • SharedStorageWorklet erlaubt aus Datenschutzgründen nur das Hinzufügen eines einzelnen Moduls. Selbst bei erfolgreicher Registrierung werden wiederholte Aufrufe von addModule() auf demselben geteilten Speicher-Worklet abgelehnt.

Auf SharedStorageWorklet wird über WindowSharedStorage.worklet zugegriffen.

Worklet SharedStorageWorklet

Beispiele

js
// Randomly assigns a user to a group 0 or 1
function getExperimentGroup() {
  return Math.round(Math.random());
}

async function injectContent() {
  // Add the module to the shared storage worklet
  await window.sharedStorage.worklet.addModule("ab-testing-worklet.js");

  // Assign user to a random group (0 or 1) and store it in shared storage
  window.sharedStorage.set("ab-testing-group", getExperimentGroup(), {
    ignoreIfPresent: true,
  });

  // Run the URL selection operation
  const fencedFrameConfig = await window.sharedStorage.selectURL(
    "ab-testing",
    [
      { url: `https://your-server.example/content/default-content.html` },
      { url: `https://your-server.example/content/experiment-content-a.html` },
    ],
    {
      resolveToConfig: true,
    },
  );

  // Render the chosen URL into a fenced frame
  document.getElementById("content-slot").config = fencedFrameConfig;
}

injectContent();

Sehen Sie sich die Shared Storage API-Einstiegsseite für eine ausführliche Anleitung zu diesem Beispiel und Links zu anderen Beispielen an.

Spezifikationen

Specification
Shared Storage API
# sharedstorageworklet

Browser-Kompatibilität

BCD tables only load in the browser

Siehe auch