Benachrichtigung: navigate-Eigenschaft
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
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 schreibgeschützte navigate-Eigenschaft der Notification-Schnittstelle enthält die URL, zu der der User-Agent navigiert, wenn der Benutzer die Benachrichtigung aktiviert.
Dies ist der aufgelöste Wert der URL, falls eine angegeben wurde, die in der navigate-Option des Notification()-Konstruktors oder in ServiceWorkerRegistration.showNotification() festgelegt wurde.
Normalerweise löst das Aktivieren einer nicht persistenten Benachrichtigung das click Ereignis auf ihrem Notification-Objekt aus, und das Aktivieren einer persistenten Benachrichtigung löst das notificationclick Ereignis im ServiceWorkerGlobalScope aus.
Wenn eine Benachrichtigung mit einer Navigations-URL vom Benutzer aktiviert wird, navigiert der User-Agent zu der angegebenen URL anstatt eines dieser Ereignisse auszulösen. Dies ermöglicht es Benachrichtigungen, Benutzer zu einer bestimmten Seite zu leiten, ohne dass ein Ereignishandler erforderlich ist.
Wert
Ein String, der eine URL enthält, oder ein leerer String, falls keine Navigations-URL gesetzt wurde.
Beispiele
Lesen des navigate-Eigenschaftswerts
Die navigate-Eigenschaft gibt den aufgelösten URL-String zurück, wenn eine Navigations-URL gesetzt wurde, oder einen leeren String andernfalls.
const notification = new Notification("New message from Alice", {
body: "Hey, are you free for lunch?",
navigate: "/messages/alice",
});
// The property contains the resolved absolute URL
console.log(notification.navigate); // e.g. "https://example.com/messages/alice"
// Without a navigate option, the property is an empty string
const basic = new Notification("Hello!");
console.log(basic.navigate); // ""
Verwendung von navigate mit einem Service Worker
Bei der Verwendung von persistenten Benachrichtigungen über einen Service Worker erlaubt die navigate-Option der Benachrichtigung, beim Aktivieren eine Seite zu öffnen, ohne dass das notificationclick-Ereignis behandelt werden muss.
// Inside a service worker
self.registration.showNotification("Order shipped!", {
body: "Your order #1234 has been shipped.",
navigate: "/orders/1234",
});
Spezifikationen
| Specification |
|---|
| Notifications API # dom-notification-navigate |