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.
Syntax
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. optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthalten kann:
dataOptional-
Ein Objekt, das alle Daten darstellt, die für die Ausführung der Operation erforderlich sind.
keepAliveOptional-
Ein boolescher Wert. Wenn auf
truegesetzt, bleibt derSharedStorageWorkletGlobalScopedes zugehörigen Worklets aktiv, und die Operation kann erneut ausgeführt werden. Daher müssen SiekeepAlivefür jede Operation auftruesetzen, die nicht die letzte sein soll. Der Standardwertfalsebedeutet, dass derSharedStorageWorkletGlobalScopenach 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.
- Das Worklet-Modul noch nicht mit
Beispiele
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.