Notification: actions Eigenschaft
Eingeschränkt verfügbar
Diese Funktion ist nicht Baseline, da sie in einigen der am weitesten verbreiteten Browser nicht funktioniert.
Sicherer Kontext: Diese Funktion ist nur in sicheren Kontexten (HTTPS) in einigen oder allen unterstützenden Browsern verfügbar.
Hinweis: Diese Funktion ist in Web Workers verfügbar.
Die schreibgeschützte actions-Eigenschaft des Notification-Interfaces stellt die Aktionen zur Verfügung, die Benutzer beim Interagieren mit der Benachrichtigung auswählen können.
Wert
Ein schreibgeschütztes Array von Aktionen. Jedes Element im Array ist ein Objekt mit den folgenden Komponenten:
action-
Ein String zur Identifizierung einer Benutzeraktion, die in der Benachrichtigung angezeigt wird.
title-
Ein String, der den Aktionstext enthält, der dem Benutzer angezeigt werden soll.
icon-
Ein String, der die URL eines Symbols enthält, das mit der Aktion angezeigt wird.
-
Ein String, der eine URL enthält, zu der navigiert werden soll, wenn der Benutzer diese Aktion aktiviert. Wenn festgelegt, navigiert der Benutzeragent zu dieser URL, anstatt das
notificationclick-Ereignis auszulösen. Weitere Informationen finden Sie unterNotification.navigate.
Beschreibung
Benachrichtigungsaktionen sind Schaltflächen oder Steuerelemente, die innerhalb von persistenten Benachrichtigungen erscheinen.
Sie werden mit der actions-Option des zweiten Arguments der showNotification()-Methode gesetzt.
Beachten Sie, dass Aktionen für nicht-persistente Benachrichtigungen nicht verfügbar sind.
Wenn Sie ein options-Objekt mit einer actions-Eigenschaft an den Notification()-Konstruktor übergeben, die nicht null ist, wird ein TypeError ausgelöst.
Das Klicken auf die Schaltfläche, die einer Aktion zugeordnet ist, navigiert zu der im navigate-Attribut angegebenen URL, falls eine festgelegt ist.
Andernfalls löst es ein notificationclick-Ereignis im Service Worker aus, das die ausgewählte Aktion (und die zugehörige Notification-Instanz) einschließt, sodass der Worker damit umgehen kann, ohne dass der Benutzer jemals zu Ihrer Seite wechseln muss.
Hinweis:
Browser beschränken typischerweise die maximale Anzahl an Aktionen, die sie für eine bestimmte Benachrichtigung anzeigen.
Überprüfen Sie die statische Notification.maxActions-Eigenschaft, um die Grenze zu bestimmen.
Beispiele
Grundlegende Verwendung
Der folgende Code zeigt, wie ein Service Worker auf das notificationclick-Ereignis horchen könnte und es verwendet, um sowohl die geklickte Aktion als auch ein Array aller Aktionen abzurufen.
// sw.js
self.addEventListener("notificationclick", (event) => {
const clickedAction = event.action; // e.g. "reply" or "" if body was clicked
// Read all defined actions
const notification = event.notification; // the Notification object
console.log(notification.actions); // full array of action objects
notification.close();
});
Spezifikationen
| Spezifikation |
|---|
| Notifications API # dom-notification-actions |