Notificações
============

**Note:** This feature is available in Web Workers

**Secure context:** This feature is available only in secure contexts (en-US) (HTTPS), in some or all supporting browsers.

A interface da API de Notificações (en-US) é usada para configurar e exibir notificações na área de trabalho do usuário. A aparência e algumas funcionalidades específicas das notificações variam entre as plataformas mas geralmente eles fornecem uma forma assíncrona de prover informações para o usuário.

Construtor
----------

`Notification()` (en-US)

Cria uma nova instancia do objeto `Notification`.

Propriedades
------------

### Propriedades estáticas

Estas propriedades estão disponíveis apenas no próprio objeto `Notification`.

`Notification.permission` (en-US) Somente leitura 

Uma sequência de caracteres que representa a permissão atual para exibir notificações. Valor possíveis são: "denied" (o usuário se recusa a ter notificações exibidas), "granted" (o usuário aceita ter notificações exibidas) ou "default" (a escolha do usuário é desconhecido e, portanto, o navegador irá agir como se o valor foram negados).

### Propriedades da instância

Estas propriedades estão disponíveis apenas em instâncias do objeto `Notification`.

`Notification.title` (en-US) Somente leitura 

Retorna o título da notificação conforme foi definido no parâmetro opções do construtor.

`Notification.dir` (en-US) Somente leitura 

A direção do texto da notificação, conforme especificado no parâmetro opções do construtor.

`Notification.lang` (en-US) Somente leitura 

O código de idioma da notificação, conforme especificado no parâmetro opções do construtor.

`Notification.body` (en-US) Somente leitura 

O corpo(mensagem) da notificação, conforme especificado no parâmetro opções do construtor.

`Notification.tag` (en-US) Somente leitura 

O ID da notificação (se houver), conforme especificado no parâmetro opções do construtor.

`Notification.icon` (en-US) Somente leitura 

A URL da imagem usada como um ícone da notificação, conforme especificado no parâmetro opções do construtor.

`Notification.data` (en-US) Somente leitura 

Retorna um clone estruturado de dados da notificação.

`Notification.silent` (en-US) Somente leitura 

Especifica se a notificação deve ser silenciosa, ou seja, sons ou vibrações não devem ser emitidos, independentemente das configurações do dispositivo.

#### Propriedades não suportadas

As propriedades a seguir estão listados na especificação mais up-to-date, mas não são suportadas em quaisquer navegadores ainda. É aconselhável manter a verificação de volta regularmente para ver se o status destes actualiza, e deixe-nos saber se você encontrar qualquer informações desatualizadas.

`Notification.noscreen` Somente leitura 

Especifica se o disparo notificação deve permitir que a tela do dispositivo ou não.

`Notification.renotify` (en-US) Somente leitura 

Especifica se o usuário deve ser notificado após uma nova notificação substitui um antigo.

`Notification.sound` Somente leitura 

Especifica um recurso de som para reproduzir durante o disparo da notificação, em vez do som de notificação do sistema padrão.

`Notification.sticky` Somente leitura 

Especifica se a notificação deve ser "fixa", ou seja, não facilmente eliminável pelo usuário.

`Notification.vibrate` (en-US) Somente leitura 

Especifica um padrão de vibração para dispositivos com hardware de vibração.

#### Manipuladores de Eventos

`Notification.onclick` (en-US)

O manipulador para o evento `click (en-US)` é acionado cada vez que o usuário clica sobre a notificação.

`Notification.onerror` (en-US)

O manipulador para o evento `error (en-US)` é acionado quando a notificação encontra um erro.

#### Manipuladores Obsoletos

Os seguintes manipuladores de eventos ainda são suportados, conforme listado na seção browser compatibility. Estes serão listados abaixo, mas não são listados na especificação atual. Saiba que eles são obsoletos, e pode parar de funcionar em versões futuras do navegador.

`Notification.onclose` (en-US)

Manipulador do evento `close` é acionado quando a notificação é fechada.

`Notification.onshow` (en-US)

Manipulador do evento `show`. é acionado quando a notificação é exibida.

Métodos
-------

### Métodos Estáticos

Estes métodos estão disponíveis apenas no próprio objeto `Notification`.

`Notification.requestPermission()` (en-US)

Solicita a permissão do usuário para exibir notificações.

### Métodos de instância

Estas propriedades estão disponíveis apenas no objeto Notification ou através do seu `prototype`. O objeto de notificação também herda a interface `EventTarget`.

`Notification.close()` (en-US)

Programaticamente fecha uma notificação.

Exemplos
--------

Leve em conta este HTML básico:


```html
<button onclick="notifyMe()">Notifique me!</button>
```


É possível enviar uma notificação da seguinte forma - aqui nós apresentamos um conjunto bastante detalhado e completo de código que você pode usar se você quiser verificar primeiro se as notificações são suportados, em seguida, verifique se a permissão foi concedida para a origem atual para enviar notificações, em seguida, solicitar permissão, se necessário, antes, em seguida, enviar uma notificação.


```js
function notifyMe() {
  // Verifica se o browser suporta notificações
  if (!("Notification" in window)) {
    alert("Este browser não suporta notificações de Desktop");
  }

  // 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.
}
```


Em muitos casos, você não precisa estar presente detalhado. Por exemplo, na nosso Emogotchi demo (veja o código fonte), basta simlesmente executar `Notification.requestPermission` (en-US) independentemente de se certificar de que pode obter permissão para enviar notificações:


```js
Notification.requestPermission();
```


Em seguida executar um simples `spawnNotification()` quando queremos disparar uma notificação — este é passado argumentos para especificar o, ícone corpo e título que queremos, então ele cria as opções necessárias objeto e dispara a notificação usando o construtor `Notification()` (en-US).


```js
function spawnNotification(corpo, icone, titulo) {
  var opcoes = {
    body: corpo,
    icon: icone,
  };
  var n = new Notification(titulo, opcoes);
}
```

Especificações
--------------

| Specification |
| --- |
| Notifications API Standard # api |

Compatibilidade com navegadores
-------------------------------

BCD tables only load in the browser with JavaScript enabled. Enable JavaScript to view data.

Veja também
-----------

* Usando a API de Notificações (en-US)