WindowSharedStorage: run()-Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, könnte sie bereits aus den relevanten Webstandards entfernt worden sein, in Kürze entfernt werden oder nur noch aus Kompatibilitätsgründen bestehen. Vermeiden Sie die Verwendung und aktualisieren Sie vorhandenen Code, falls möglich; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu unterstützen. Beachten Sie, dass diese Funktion jederzeit aufhören könnte zu funktionieren.

Die run()-Methode der WindowSharedStorage-Schnittstelle führt eine Run-Operation aus, die in einem Modul registriert ist, das zum aktuellen Ursprung in dem SharedStorageWorklet hinzugefügt wurde.

Hinweis: Das Run-Ausgabe-Gate ist als generischer Weg zur Verarbeitung einiger gemeinsam genutzter Speicher-Daten gedacht.

In diesem Artikel

Syntax

js
run(name)
run(name, options)

Parameter

name

Ein String, der den Namen der innerhalb des Shared Storage Worklet-Moduls registrierten Operation darstellt. Er muss mit dem Namen übereinstimmen, der der Operation beim Registrieren mit SharedStorageWorkletGlobalScope.register() gegeben wurde.

options Optional

Ein Optionsobjekt, das die folgenden Eigenschaften enthalten kann:

data Optional

Ein Objekt, das alle Daten darstellt, die für die Ausführung der Operation erforderlich sind.

keepAlive Optional

Ein boolescher Wert. Wenn auf true gesetzt, bleibt der SharedStorageWorkletGlobalScope des zugehörigen Worklets aktiv, und die Operation kann erneut ausgeführt werden. Daher müssen Sie keepAlive für jede Operation auf true setzen, die nicht die letzte sein soll. Der Standardwert false bedeutet, dass der SharedStorageWorkletGlobalScope nach der Ausführung der Operation beendet wird und nicht erneut ausgeführt werden kann.

Rückgabewert

Ein Promise, das mit undefined erfüllt wird.

Ausnahmen

TypeError

Ausgelöst, wenn:

Das Worklet-Modul noch nicht mit addModule() hinzugefügt wurde.
Der gemeinsame Speicher (zum Beispiel über eine Browsereinstellung) deaktiviert ist.
Die aufrufende Seite die Shared Storage API nicht in einem erfolgreichen Privatsphäre-Sandbox-Einschreibungsprozess enthalten hat.

Beispiele

js
async function measureUniqueReach() {
  // Load the Shared Storage worklet
  await window.sharedStorage.worklet.addModule("reach-measurement-worklet.js");

  // Run the reach measurement operation
  await window.sharedStorage.run("reach-measurement", {
    data: { contentId: "1234" },
  });
}

measureUniqueReach();

Siehe Messung der eindeutigen Reichweite für eine vollständige Erklärung dieses Beispiels. Weitere Beispiele finden Sie in der Shared Storage API.

Shared Storage API

Help improve MDN

War diese Übersetzung hilfreich?

Ja Nein

Erfahren Sie, wie Sie beitragen können Diese Seite wurde automatisch aus dem Englischen übersetzt.

Übersetzung auf GitHub anzeigen • Fehler mit dieser Übersetzung melden

Shared Storage API
WindowSharedStorage
Instanzeigenschaften
1. worklet
Instanzmethoden
1. run()
2. selectURL()
Verwandte Seiten für Shared Storage API