Notification#

Wstęp#

Interfejs Notification stanowi definicję Web IDL dla obiektów reprezentujących powiadomienia.

Każde powiadomienie # (notification) posiada tytuł # (title), ciało # (body), kierunek # (direction), język # (language), etykietę # (tag), dane # (data) oraz pochodzenie # (origin).

Każde powiadomienie może być powiązane z URL ikony # (icon URL) oraz obrazem ikony # (icon image).

Interfejs Notification dziedziczy po interfejsie EventTarget, dlatego ma dostęp do wszystkich poleceń z tego interfejsu (oraz z kolejnych interfejsów w łańcuchu dziedziczenia).

Powiadomienie można utworzyć za pomocą polecenia:

new Notification()

Właściwości Notification#

Nazwa	Opis
`Notification.body`	Zwraca łańcuch znakowy reprezentujący ciało danego powiadomienia.
`Notification.dir`	Zwraca łańcuch znakowy reprezentujący kierunek danego powiadomienia.
`Notification.icon`	Zwraca łańcuch znakowy reprezentujący URL ikony danego powiadomienia.
`Notification.lang`	Zwraca łańcuch znakowy reprezentujący główny język danego powiadomienia.
`Notification.onclick`	Ustawia w danym powiadomieniu uchwyt zdarzenia dla zdarzenia `click`.
`Notification.onclose`	Ustawia w danym powiadomieniu uchwyt zdarzenia dla zdarzenia `close`.
`Notification.onerror`	Ustawia w danym powiadomieniu uchwyt zdarzenia dla zdarzenia `error`.
`Notification.onshow`	Ustawia w danym powiadomieniu uchwyt zdarzenia dla zdarzenia `show`.
`Notification.permission`	Zwraca łańcuch znakowy informujący o aktualnym zezwoleniu wyświetlania powiadomień dla danego pochodzenia.
`Notification.tag`	Zwraca łańcuch znakowy reprezentujący etykietę danego powiadomienia.
`Notification.title`	Zwraca łańcuch znakowy reprezentujący tytuł danego powiadomienia.

Metody Notification#

Nazwa	Opis
`Notification.close()`	Zamyka dane powiadomienie.
`Notification.requestPermission()`	Wysyła prośbę o ustawienie zezwolenia wyświetlania powiadomień dla danego pochodzenia.

Inne Range#

Nazwa	Opis
`new Notification()`	Konstruktor tworzący nowy powiadomienie.

Interfejs Web IDL#

[Constructor(DOMString title, optional NotificationOptions options), Exposed=Window,Worker]
interface Notification : EventTarget {
	static readonly attribute NotificationPermission permission;
	static void requestPermission(optional NotificationPermissionCallback callback);

	static Promise<sequence<Notification>> getClones(optional
							 GetNotificationClonesOptions filter);

	attribute EventHandler onclick;
	attribute EventHandler onshow;
	attribute EventHandler onerror;
	attribute EventHandler onclose;

	readonly attribute DOMString title;
	readonly attribute NotificationDirection dir;
	readonly attribute DOMString lang;
	readonly attribute DOMString body;
	readonly attribute DOMString tag;
	readonly attribute DOMString icon;
	[SameObject] readonly attribute any data;

	void close();
};

dictionary NotificationOptions {
	NotificationDirection dir = "auto";
	DOMString lang = "";
	DOMString body = "";
	DOMString tag = "";
	DOMString icon;
	any data = null;
};

dictionary GetNotificationClonesOptions {
	DOMString tag = "";
};

enum NotificationPermission {
	"default",
	"denied",
	"granted"
};

callback NotificationPermissionCallback = void (NotificationPermission permission);

enum NotificationDirection {
	"auto",
	"ltr",
	"rtl"
};

Specyfikacje i inne materiały#

Mozilla Developer Network

Pasek społecznościowy