The NativeWindow object is only available to privileged code running on Firefox for Android, and is intended for use by Firefox for Android add-ons.

NativeWindow.toast will be deprecated in Firefox 45.

New code should use Snackbars.jsm to display notifications. To maintain backward compatibility NativeWindow.toast will still work, by delegating calls to Snackbars.jsm.

Summary displays a toast notification on Firefox for Android.

A toast notification is a message that appears on the screen for a set interval and then fades away. It does not accept user input.

Syntax, duration);

The message displayed by the toast.

How long the toast should appear before fading away. This can take one of two values, short or long.

A set of options for the toast. See the "Supported options" section below

Supported options


Attribute Description
label The label for the button. This text won't be formatted like a link. Keep it a short single word to make it feel clickable.
icon An icon for the button. This can be a base64 encded url, a chrome/resource url, or a drawable url.
callback A callback that is called when you tap the icon. The function isn't passed any arguments.


In the example below, an add-on adds a menu item that displays a toast:

function showToast(window) {"Showing you a toast", "short", {
    button: {
      label: "Undo",
      icon: "drawable://alert_app",
      callback: function() {
        Services.prompts.alert("You clicked the button");

function addMenuItem(window) {
  menuID ="Show Toast", null, function() {

function removeMenuItem(window) {;

See Also

Document Tags and Contributors

 Contributors to this page: wbamberg, dkocho4, leibovic, wesj, justinpotts
 Last updated by: wbamberg,