Gio.Notification

const Gio = imports.gi.Gio;

let notification = new Gio.Notification();
  

Gio.Notification is a mechanism for creating a notification to be shown to the user -- typically as a pop-up notification presented by the desktop environment shell.

The key difference between Gio.Notification and other similar APIs is that, if supported by the desktop environment, notifications sent with Gio.Notification will persist after the application has exited, and even across system reboots.

Since the user may click on a notification while the application is not running, applications using Gio.Notification should be able to be started as a D-Bus service, using Gio.Application.

User interaction with a notification (either the default action, or buttons) must be associated with actions on the application (ie: "app." actions). It is not possible to route user interaction through the notification itself, because the object will not exist if the application is autostarted as a result of a notification being clicked.

A notification can be sent with Gio.Application.prototype.send_notification.

Since 2.40

Hierarchy

  • GObject.Object
    • Gio.Notification