WindowSharedStorage: Methode run()
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 Ausführungsoperation aus, die in einem Modul registriert ist, das dem aktuellen Ursprung im SharedStorageWorklet hinzugefügt wurde.
Hinweis: Das Run Output Gate ist als generische Möglichkeit gedacht, einige gemeinsame Speicherungsdaten zu verarbeiten.
Syntax
run(name)
run(name, options)
Parameter
name-
Ein String, der den Namen der registrierten Operation innerhalb des Shared Storage Worklet-Moduls darstellt. Er muss mit dem Namen übereinstimmen, der der Operation gegeben wurde, als sie mit
SharedStorageWorkletGlobalScope.register()registriert wurde. optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthalten kann:
dataOptional-
Ein Objekt, das alle Daten darstellt, die zur Ausführung der Operation erforderlich sind.
keepAliveOptional-
Ein boolescher Wert. Wenn auf
truegesetzt, bleibt derSharedStorageWorkletGlobalScopedes assoziierten Worklets aktiv, und die Operation kann erneut ausgeführt werden. Daher müssen Sie für jede Operation, die nicht die letzte sein soll,keepAliveauftruesetzen. 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-
Wird ausgelöst, wenn:
- Das Worklet-Modul noch nicht mit
addModule()hinzugefügt wurde. - Gemeinsame Speicherung deaktiviert ist (zum Beispiel über eine Browsereinstellung).
- Die aufrufende Stelle die Shared Storage API nicht in einem erfolgreichen Privatsphäre-Sandbox-Einschreibungsprozess eingeschlossen 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 einzigartigen Reichweite für eine vollständige Erklärung dieses Beispiels. Weitere Beispiele finden Sie in der Shared Storage API.