WindowSharedStorage: run() Methode
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Die run()
-Methode des WindowSharedStorage
-Interfaces führt eine Run-Operation aus, die in einem Modul registriert ist und zum aktuellen Ursprung des SharedStorageWorklet
hinzugefügt wurde.
Hinweis: Das Run-Ausgabegate ist als generische Methode gedacht, um einige gemeinsame Speicher daten zu verarbeiten.
Syntax
run(name)
run(name, options)
Parameter
name
-
Ein String, der den Namen der registrierten Operation innerhalb des Shared-Storage-Worklet-Moduls repräsentiert. Er muss mit dem Namen übereinstimmen, der der Operation gegeben wird, wenn sie mit
SharedStorageWorkletGlobalScope.register()
registriert wird. options
Optional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthalten kann:
data
Optional-
Ein Objekt, das alle Daten repräsentiert, die für die Ausführung der Operation erforderlich sind.
keepAlive
Optional-
Ein boolescher Wert. Wenn auf
true
gesetzt, bleibt derSharedStorageWorkletGlobalScope
des zugehörigen Worklets aktiv, und die Operation kann erneut ausgeführt werden. Daher musskeepAlive
auftrue
gesetzt werden für jede Operation, die nicht die letzte sein soll. Der Standardwertfalse
bedeutet, dass derSharedStorageWorkletGlobalScope
nach der Ausführung der Operation beendet wird und nicht erneut ausgeführt werden kann.
Rückgabewert
Ein Promise
das sich mit undefined
erfüllt.
Ausnahmen
TypeError
-
Wird ausgelöst, wenn:
- Das Worklet-Modul noch nicht mit
addModule()
hinzugefügt wurde. - Shared Storage deaktiviert ist (zum Beispiel über eine Browsereinstellung).
- Die aufrufende Stelle die Shared Storage API nicht in einem erfolgreichen Privacy Sandbox-Anmeldeprozess 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();
Sehen Sie sich die Unique Reach Measurement für eine vollständige Erklärung dieses Beispiels an. Weitere Beispiele finden Sie in der Shared Storage API.
Spezifikationen
No specification found
No specification data found for api.WindowSharedStorage.run
.
Check for problems with this page or contribute a missing spec_url
to mdn/browser-compat-data. Also make sure the specification is included in w3c/browser-specs.
Browser-Kompatibilität
No compatibility data found for api.WindowSharedStorage.run
.
Check for problems with this page or contribute missing data to mdn/browser-compat-data.