PeriodicSyncManager: Methode register()
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimentell: Dies ist eine experimentelle Technologie
Überprüfen Sie die Browser-Kompatibilitätstabelle sorgfältig vor der Verwendung auf produktiven Webseiten.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die register()-Methode des
PeriodicSyncManager-Interfaces registriert eine periodische Synchronisierungsanfrage beim
Browser mit dem angegebenen Tag und Optionen. Sie gibt ein Promise
zurück, das sich auflöst, wenn die Registrierung abgeschlossen ist.
Syntax
register(tag, options)
Parameter
tag-
Ein einzigartiger
String-Identifikator. optionsOptional-
Ein
Objectenthält die folgenden optionalen Daten:minInterval-
Die minimale Intervallzeit in Millisekunden, in der die periodische Synchronisierung erfolgen soll.
Rückgabewert
Ausnahmen
InvalidStateErrorDOMException-
Wird zurückgegeben, wenn kein aktiver
ServiceWorkervorhanden ist. NotAllowedErrorDOMException-
Wird zurückgegeben, wenn die Erlaubnis für die Hintergrundperiodensynchronisation nicht erteilt ist.
InvalidAccessErrorDOMException-
Wird zurückgegeben, wenn das aktive Fenster nicht das Hauptfenster ist (nicht vom Typ
auxiliaryodertop-level).
Beispiele
Die folgende asynchrone Funktion registriert eine periodische Hintergrundsynchronisation mit einem minimalen Intervall von einem Tag aus einem Browsing-Kontext:
async function registerPeriodicNewsCheck() {
const registration = await navigator.serviceWorker.ready;
try {
await registration.periodicSync.register("fetch-news", {
minInterval: 24 * 60 * 60 * 1000,
});
} catch {
console.log("Periodic Sync could not be registered!");
}
}
Spezifikationen
| Specification |
|---|
| Web Periodic Background Synchronization # dom-periodicsyncmanager-register |
Browser-Kompatibilität
Loading…