notifications

Display transient, toaster-style desktop messages to the user.

Usage

This API supports desktop notifications on Windows, OS X using Growl (and Notification Center as of OS X 10.9 Mavericks), and Linux using libnotify.

Here's a typical example. When the message is clicked, a string is logged to the console.

var notifications = require("sdk/notifications");
notifications.notify({
  title: "Jabberwocky",
  text: "'Twas brillig, and the slithy toves",
  data: "did gyre and gimble in the wabe",
  onClick: function (data) {
    console.log(data);
    // console.log(this.data) would produce the same result.
  }
});

This one displays an icon that's stored in the add-on's data directory. See the self module documentation for more information.

var notifications = require("sdk/notifications");
var self = require("sdk/self");
var myIconURL = self.data.url("myIcon.png");
notifications.notify({
  text: "I have an icon!",
  iconURL: myIconURL
});

var notifications = require("sdk/notifications");
var myIconURL = "./myIcon.png";
notifications.notify({
  text: "I have an icon!",
  iconURL: myIconURL
});

This module depends on the underlying system's notification service. If the user's system does not support desktop notifications or if its notifications service is not running:

• if Firefox was started normally, notifications are logged to Firefox's error console
• if the user launched Firefox from the command line, notifications are logged to the terminal.

Globals

Functions

notify(options)

Displays a transient notification to the user.

Parameters

options : object
Optional options: