Questa traduzione è incompleta. Collabora alla traduzione di questo articolo dall’originale in lingua inglese.

L'interfaccia Notification di Notifications API viene usata per configurare e mostrare le notifiche desktop all'utente.

Note: This feature is available in Web Workers.

Costruttore

Notification()
Crea una nuova istanza dell'oggetto Notification.

Proprietà

Proprietà Static

Queste proprietà sono disponibili solo sull'oggetto Notification stesso.

Notification.permission Read only
Una stringa che rappresenta l'attuale permesso per mostrare le notifiche. I possibili valori sono: denied (l'utente rifiuta la ricezione delle notifiche), granted (l'utente accetta la ricezione delle notifiche), o default (la scelta dell'utente è sconosciuta, quindi il browser agirà come se il valore fosse negato).

Proprietà Instance

Queste proprietà sono disponibili solo su istanze dell'oggetto Notification.

Notification.actions Read only
L'array di azioni della notifica come specificato nel parametro options del costruttore.
Notification.badge Read only
L'URL dell'immagine utilizzata per rappresentare la notifica quando non c'è abbastanza spazio per visualizzare la notifica stessa.
Notification.body Read only
La stringa del corpo della notifica come specificato nel parametro options del costruttore.
Notification.data Read only
Restituisce un clone strutturato dei dati della notifica.
Notification.dir Read only
La direzione del testo della notifica come specificato nel parametro options del costruttore.
Notification.lang Read only
Il codice della lingua della notifica come specificato nel parametro options del costruttore.
Notification.tag Read only
L'ID della notifica (se presente) come specificato nel parametro options del costruttore.
Notification.icon Read only
L'URL dell'immagine utilizzata come icona della notifica come specificato nel parametro options del costruttore.
Notification.image Read only
L'URL di un'immagine da visualizzare come parte della notifica, come specificato nel parametro options del costruttore.
Notification.requireInteraction Read only
Un Boolean che indica che una notifica deve rimanere attiva finché l'utente non fa click o non la chiude, anziché chiudersi automaticamente.
Notification.silent Read only
Specifica se la notifica deve essere silenziosa, ovvero che non emetta suoni o vibrazioni, indipendentemente dalle impostazioni del dispositivo.
Notification.timestamp Read only
Specifica l'ora in cui viene creata o applicata una notifica (passato, presente o fututo).
Notification.title Read only
Il titolo della notifica come specificato nel primo parametro del costruttore.
Notification.vibrate Read only
Specifica un modello di vibrazione da emettere per i dispositivi con hardware di vibrazione.

Proprietà non supportate

Le seguenti proprietà sono elencate nelle specifiche più aggiornate, ma non sono ancora supportate da alcuni browser. È consigliabile controllare regolarmente per vedere se lo stato di queste proprietà viene aggiornato, e facci sapere se trovi informazioni non aggiornate.

Notification.noscreen Read only
Specifica se l'attivazione della notifica deve abilitare o meno lo schermo del dispositivo.
Notification.renotify Read only
Specifica se l'utente deve essere avvisato dopo che una nuova notifica sostituisce una vecchia.
Notification.sound Read only
Specifica una risorsa sonora da riprodurre quando scatta la notifica, al prosto del suono di notifica predefinito del sistema.
Notification.sticky Read only
Specifica se la notifica deve essere "sticky", cioè non facilmente modificabile dall'utente.

Gestori di eventi

Notification.onclick
Un gestore per l'evento click. Viene attivato ogni volta che l'utente fa click sulla notifica.
Notification.onerror
Un gestore per l'evento error. Viene attivato ogni volta che la notifica incontra un errore.

Obsolete handlers

The following event handlers are still supported as listed in the browser compatibility section below, but are no longer listed in the current spec. It is safe therefore to assume they are obsolete, and may stop working in future browser versions.

Notification.onclose
A handler for the close event. It is triggered when the user closes the notification.
Notification.onshow
A handler for the show event. It is triggered when the notification is displayed.

Methods

Static methods

These methods are available only on the Notification object itself.

Notification.requestPermission()
Requests permission from the user to display notifications.

Instance methods

These properties are available only on an instance of the Notification object or through its prototype. The Notification object also inherits from the EventTarget interface.

Notification.close()
Programmatically closes a notification.

Example

Assume this basic HTML:

<button onclick="notifyMe()">Notify me!</button>

It's possible to send a notification as follows — here we present a fairly verbose and complete set of code you could use if you wanted to first check whether notifications are supported, then check if permission has been granted for the current origin to send notifications, then request permission if required, before then sending a notification.

function notifyMe() {
  // Let's check if the browser supports notifications
  if (!("Notification" in window)) {
    alert("This browser does not support desktop notification");
  }

  // Let's check whether notification permissions have already been granted
  else if (Notification.permission === "granted") {
    // If it's okay let's create a notification
    var notification = new Notification("Hi there!");
  }

  // Otherwise, we need to ask the user for permission
  else if (Notification.permission !== 'denied') {
    Notification.requestPermission(function (permission) {
      // If the user accepts, let's create a notification
      if (permission === "granted") {
        var notification = new Notification("Hi there!");
      }
    });
  }

  // At last, if the user has denied notifications, and you 
  // want to be respectful there is no need to bother them any more.
}

In many cases, you don't need to be this verbose. For example, in our Emogotchi demo (see source code), we simply run Notification.requestPermission regardless to make sure we can get permission to send notifications (this uses the newer promise-based method syntax):

Notification.requestPermission().then(function(result) {
  console.log(result);
});

Then we run a simple spawnNotification() function when we want to fire a notification — this is passed arguments to specify the body, icon and title we want, then it creates the necessary options object and fires the notification using the Notification() constructor.

function spawnNotification(theBody,theIcon,theTitle) {
  var options = {
      body: theBody,
      icon: theIcon
  }
  var n = new Notification(theTitle,options);
}

Specifications

Specification Status Comment
Notifications API Living Standard Living standard

Browser compatibility

We're converting our compatibility data into a machine-readable JSON format. This compatibility table still uses the old format, because we haven't yet converted the data it contains. Find out how you can help!

Feature Chrome Edge Firefox (Gecko) Internet Explorer Opera Safari
Basic support 5webkit[1]
22
(Yes) 4.0 moz[2]
22
No support 25 6[3]
icon 5webkit[1]
22
? 4.0 moz[2]
22
No support 25 No support
Available in workers (Yes) ? 41.0 (41.0) ? ? ?
silent 43.0 ? No support No support No support No support
noscreen, sticky No support ? No support No support No support No support
sound No support ? No support No support No support No support
renotify 50.0 ? No support No support No support No support
Promise-based Notification.requestPermission() 46.0 ? 47.0 (47.0) ? 40 No support
vibrate, actions 53.0 ?     39  
badge 53.0 ?     39  
image 55.0 ?     ?  
Feature Android Android Webview Edge Firefox Mobile (Gecko) Firefox OS IE Mobile Opera Mobile Safari Mobile Chrome for Android
Basic support ?

(Yes)

(Yes) 4.0moz[2]
22
1.0.1moz[2]
1.2
No support ? No support

(Yes)

icon ? (Yes) ? 4.0moz[2]
22
1.0.1moz[2]
1.2
No support ? No support (Yes)
Available in workers ? (Yes) ? 41.0 (41.0) ? ? ? ? (Yes)
silent No support 43.0 ? No support No support No support No support No support 43.0
noscreen, sticky No support No support ? No support No support No support No support No support No support
sound No support (Yes) ? No support No support No support No support No support (Yes)
renotify No support 50.0 ? No support No support No support No support No support No support
Promise-based Notification.requestPermission() ? ? ? 47.0 (47.0) ? ? ? ? ?
vibrate, actions No support 53.0 ?       39   53.0
badge No support 53.0 ?       39   53.0
image No support No support ?       ?   55.0

[1] Before Chrome 22, the support for notification followed an old prefixed version of the specification and used the navigator.webkitNotifications object to instantiate a new notification.

Before Chrome 32, Notification.permission was not supported.

Before Chrome 42, service worker additions were not supported.

Starting in Chrome 49, notifications do not work in incognito mode.

[2] Prior to Firefox 22 (Firefox OS <1.2), the instantiation of a new notification must be done with the navigator.mozNotification object through its createNotification method.

Prior to Firefox 22 (Firefox OS <1.2), the Notification was displayed when calling the show method and supported only the click and close events.

Nick Desaulniers wrote a Notification shim to cover both newer and older implementations.

One particular Firefox OS issue is that you can pass a path to an icon to use in the notification, but if the app is packaged you cannot use a relative path like /my_icon.png. You also can't use window.location.origin + "/my_icon.png" because window.location.origin is null in packaged apps. The manifest origin field fixes this, but it is only available in Firefox OS 1.1+. A potential solution for supporting Firefox OS <1.1 is to pass an absolute URL to an externally hosted version of the icon. This is less than ideal as the notification is displayed immediately without the icon, then the icon is fetched, but it works on all versions of Firefox OS.

When using notifications  in a Firefox OS app, be sure to add the desktop-notification permission in your manifest file. Notifications can be used at any permission level, hosted or above: "permissions": { "desktop-notification": {} }

[3] Safari started to support notification with Safari 6, but only on Mac OSX 10.8+ (Mountain Lion).

See also

Tag del documento e collaboratori

Hanno collaborato alla realizzazione di questa pagina: mdnwebdocs-bot, francymin, Mascare
Ultima modifica di: mdnwebdocs-bot,