WindowSharedStorage: run()-Methode
Deprecated
Avoid using this feature in new projects. This feature may be a candidate for removal from web standards or browsers.
Die run()-Methode der WindowSharedStorage-Schnittstelle führt eine Laufausführung aus, die in einem Modul registriert ist, das dem aktuellen Ursprung im SharedStorageWorklet hinzugefügt wurde.
Hinweis: Das Run-Ausgabegate ist als generische Methode gedacht, um einige gemeinsame Speicherdateien zu verarbeiten.
Syntax
run(name)
run(name, options)
Parameter
name-
Ein Zeichenfolgentext, der den Namen der registrierten Operation innerhalb des Shared Storage Worklet-Moduls darstellt. Er muss mit dem Namen übereinstimmen, der bei der Registrierung mit
SharedStorageWorkletGlobalScope.register()vergeben wurde. optionsOptional-
Ein Optionsobjekt, das die folgenden Eigenschaften enthalten kann:
dataOptional-
Ein Objekt, das alle für die Ausführung der Operation benötigten Daten darstellt.
keepAliveOptional-
Ein Boolean-Wert. Wenn auf
truegesetzt, bleibt derSharedStorageWorkletGlobalScopedes zugehörigen Worklets aktiv, und die Operation kann erneut ausgeführt werden. Daher müssen SiekeepAliveauftruesetzen für jede Operation, die nicht als letzte gedacht ist. Der Standardwert,false, bedeutet, dass derSharedStorageWorkletGlobalScopenach der Ausführung der Operation beendet wird und nicht erneut ausgeführt werden kann.
Rückgabewert
Ein Promise, das erfüllt wird mit undefined.
Ausnahmen
TypeError-
Ausgelöst, wenn:
- Das Worklet-Modul noch nicht mit
addModule()hinzugefügt wurde. - Der gemeinsame Speicher deaktiviert ist (zum Beispiel über eine Browsereinstellung).
- Der aufrufende Standort die Shared Storage API nicht als Teil eines erfolgreichen Privacy Sandbox Einschreibungsprozesses 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();
Sehen Sie sich Unique reach measurement für eine vollständige Erklärung dieses Beispiels an. Weitere Beispiele finden Sie in der Shared Storage API.