SharedStorageWorkletGlobalScope: register()-Methode
Deprecated
To be removed
This feature is pending removal from browsers. Using it now may lead to broken functionality in future updates. Following the announcement that Chrome will maintain its current approach to third-party cookies, Chrome decided to withdraw certain Privacy Sandbox features including the shared storage.
Nicht standardisiert: Diese Funktion ist nicht standardisiert. Wir raten davon ab, nicht-standardisierte Funktionen auf produktiven Webseiten zu verwenden, da sie nur von bestimmten Browsern unterstützt werden und sich in Zukunft ändern oder entfernt werden können. Unter Umständen kann sie jedoch eine geeignete Option sein, wenn es keine standardisierte Alternative gibt.
Die register()-Methode der SharedStorageWorkletGlobalScope-Schnittstelle registriert eine Operation, die innerhalb des aktuellen Worklet-Moduls definiert ist.
Syntax
register(name, operationCtor)
Parameter
name-
Ein String, der den Namen darstellt, unter dem die Operation registriert werden soll. Wenn die Operation aufgerufen wird (zum Beispiel über
WindowSharedStorage.run()oderWindowSharedStorage.selectURL()), wird dieser Name verwendet, um die Operation zu identifizieren, die ausgeführt werden soll. operationCtor-
Ein String, der den Klassennamen der zu registrierenden Operation darstellt. Dies ist der Klassenkonstruktor, der aufgerufen wird, wenn die Operation ausgeführt wird.
Rückgabewert
Keiner (undefined).
Ausnahmen
TypeError-
Wird ausgelöst, wenn:
- Eine Operation mit dem angegebenen Namen bereits registriert wurde.
- Der
operationCtorkein gültiger Konstruktor ist. - Die Klasse keine gültige
run()-Methode enthält. - Das Worklet-Modul nicht mit
SharedStorageWorklet.addModule()hinzugefügt wurde.
Beispiele
// ab-testing-worklet.js
class SelectURLOperation {
async run(urls, data) {
// Read the user's experiment group from shared storage
const experimentGroup = await this.sharedStorage.get("ab-testing-group");
// Return the group number
return experimentGroup;
}
}
register("ab-testing", SelectURLOperation);
Siehe die Shared Storage API Hauptseite für eine ausführliche Erklärung dieses Beispiels und Links zu weiteren Beispielen.
Hinweis:
Es ist möglich, mehrere Operationen im selben Shared Storage Worklet-Modulskript mit unterschiedlichen Namen zu definieren und zu registrieren; siehe SharedStorageOperation für ein Beispiel.