signals

• dismissed: (id: number) notification removed from popups
• notified: (id: number) notification added to popups and notifications
• closed: (id: number) notification removed from popups and notifications

properties

• popupTimeout: number: milliseconds, 3000 by default
• forceTimeout: boolean: Force every notifications timeout to be popupTimeout. false by default.
• cacheActions: boolean: Action buttons don't work if the sender process is no longer running. So on reboot they won't work. false by default
• clearDelay: number: milliseconds to wait after each notification closed when calling clear. This is to prevent crashes when its not handled by the user.
• dnd: boolean: do no disturb, it will permit the notification to be added to Notifications.popups
• popups: Notification[]
• notifications: Notification[]

methods

• clear: () => void: removes all notifications
• getNotification: (id: number) => Notification
• getPopup: (id: number) => Notification

Notification

signals

• dismissed notification.popup became false
• closed
• invoked: (action: string)

properties

• id: number
• app-name: string
• app-entry: string | null .desktop file
• app-icon: string
• summary: string title
• body: string
• actions: Array<{ id: string, label: string }>
• urgency: "low" | "normal" | "critical"
• time: number you can GLib.DateTime.new_from_unix_local(time)
• image: string | null path to the image
• popup: boolean whether this should show as a popup banner
• hints: Record<string, GLib.Variant> notification hints, these are not cached and this returns an empty object if loaded from cache

methods

• dismiss () => void sets popup to false
• close () => void
• invoke (actionId: string) => void invoking an action will also close the notification

Example

const notifications = await Service.import("notifications");
notifications.popupTimeout = 3000;
notifications.forceTimeout = false;
notifications.cacheActions = false;
notifications.clearDelay = 100;

Widget.Label({
  label: notifications.bind("notifications").as((n) =>
    `there are ${n.length} notifications`
  ),
});
Copy

Example Notification Popups

(Image: notifs)