browser.notifications

Descrição

Use a API chrome.notifications para criar notificações avançadas usando modelos e mostre essas notificações aos usuários na bandeja do sistema.

Permissões

notifications

Tipos

NotificationBitmap

NotificationButton

Propriedades

  • iconUrl

    string opcional

    Descontinuado desde o Chrome 59

    Os ícones de botão não estão visíveis para usuários do Mac OS X.

  • título

    string

NotificationItem

Propriedades

  • mensagem

    string

    Mais detalhes sobre este item.

  • título

    string

    Título de um item de uma notificação de lista.

NotificationOptions

Propriedades

  • appIconMaskUrl

    string opcional

    Descontinuado desde o Chrome 59

    A máscara do ícone do app não fica visível para usuários do Mac OS X.

    Um URL para a máscara do ícone do app. Os URLs têm as mesmas restrições que iconUrl.

    A máscara do ícone do app precisa estar no canal Alfa, já que apenas esse canal da imagem será considerado.

  • botões

    NotificationButton[] opcional

    Texto e ícones para até dois botões de ação de notificação.

  • contextMessage

    string opcional

    Conteúdo de notificação alternativo com uma fonte de menor peso.

  • eventTime

    número optional

    Um carimbo de data/hora associado à notificação, em milissegundos após o período (por exemplo, Date.now() + n).

  • iconUrl

    string opcional

    Um URL para o avatar do remetente, o ícone do app ou uma miniatura para notificações de imagem.

    Os URLs podem ser de dados, de blob ou relativos a um recurso no arquivo .crx desta extensão.

    **Observação**: esse valor é obrigatório para o método notifications.create().

  • imageUrl

    string opcional

    Descontinuado desde o Chrome 59

    A imagem não fica visível para usuários do Mac OS X.

    Um URL para a miniatura de imagem de notificações do tipo imagem. Os URLs têm as mesmas restrições que iconUrl.

  • isClickable

    booleano opcional

    Descontinuado desde o Chrome 67

    Essa dica de interface é ignorada desde o Chrome 67.

  • itens

    NotificationItem[] opcional

    Itens para notificações de vários itens. Os usuários do Mac OS X só veem o primeiro item.

  • mensagem

    string opcional

    Conteúdo principal da notificação.

    **Observação**: esse valor é obrigatório para o método notifications.create().

  • prioridade

    número optional

    A prioridade varia de -2 a 2. -2 é a prioridade mais baixa. 2 é a mais alta. Zero é o padrão. Em plataformas que não oferecem suporte a uma central de notificações (Windows, Linux e Mac), -2 e -1 resultam em um erro, já que as notificações com essas prioridades não são mostradas.

  • progresso

    número optional

    O progresso atual varia de 0 a 100.

  • requireInteraction

    booleano opcional

    Chrome 50+ browser.* desde o Chrome 148

    Indica que a notificação precisa permanecer visível na tela até que o usuário a ative ou dispense. O padrão é false.

  • silencioso

    booleano opcional

    Chrome 70+ browser.* desde o Chrome 148

    Indica que nenhum som ou vibração deve ser emitido quando a notificação é mostrada. O padrão é false.

  • título

    string opcional

    Título da notificação (por exemplo, nome do remetente do e-mail).

    **Observação**: esse valor é obrigatório para o método notifications.create().

  • tipo

    TemplateType opcional

    O tipo de notificação a ser exibido. Obrigatório para o método notifications.create.

PermissionLevel

Enumeração

"granted"
Especifica que o usuário optou por mostrar notificações do app ou da extensão. Esse é o padrão no momento da instalação.

"denied"
Especifica que o usuário optou por não mostrar notificações do app ou da extensão.

TemplateType

Enumeração

"basic"
Contém um ícone, um título, uma mensagem, uma mensagem expandida e até dois botões.

"image"
Contém um ícone, título, mensagem, expandedMessage, imagem e até dois botões.

"list"
Contém um ícone, um título, uma mensagem, itens e até dois botões. Os usuários do Mac OS X só veem o primeiro item.

"progress"
Contém um ícone, um título, uma mensagem, o progresso e até dois botões.

Métodos

clear()

browser.notifications.clear(
  notificationId: string,
): Promise<boolean>

Limpa a notificação especificada.

Parâmetros

  • notificationId

    string

    O ID da notificação a ser removida. Isso é retornado pelo método notifications.create.

Retorna

  • Promise<boolean>

    Chrome 116+ browser.* desde o Chrome 148

    Retorna uma promessa que é resolvida para indicar se havia uma notificação correspondente.

create()

browser.notifications.create(
  notificationId?: string,
  options: NotificationOptions,
): Promise<string>

Cria e mostra uma notificação.

Parâmetros

  • notificationId

    string opcional

    Identificador da notificação. Se não for definido ou estiver vazio, um ID será gerado automaticamente. Se houver uma correspondência, esse método vai limpar a notificação antes de prosseguir com a operação de criação. O identificador não pode ter mais de 500 caracteres.

    O parâmetro notificationId é obrigatório antes do Chrome 42.

  • Conteúdo da notificação.

Retorna

  • Promise<string>

    Chrome 116+ browser.* desde o Chrome 148

    Retorna uma promessa que é resolvida com o ID da notificação (fornecido ou gerado) que representa a notificação criada.

getAll()

browser.notifications.getAll(): Promise<object>

Recupera todas as notificações desse app ou extensão.

Retorna

  • Promise<object>

    Chrome 116+ browser.* desde o Chrome 148

    Retorna uma promessa que é resolvida com o conjunto de notification_ids atualmente no sistema.

getPermissionLevel()

browser.notifications.getPermissionLevel(): Promise<PermissionLevel>

Informa se o usuário ativou as notificações do app ou da extensão.

Retorna

  • Promise<PermissionLevel>

    Chrome 116+ browser.* desde o Chrome 148

    Retorna uma promessa que é resolvida com o nível de permissão atual.

update()

browser.notifications.update(
  notificationId: string,
  options: NotificationOptions,
): Promise<boolean>

Atualiza uma notificação.

Parâmetros

Retorna

  • Promise<boolean>

    Chrome 116+ browser.* desde o Chrome 148

    Retorna uma promessa que é resolvida para indicar se havia uma notificação correspondente.

Eventos

onButtonClicked

browser.notifications.onButtonClicked.addListener(
  callback: function,
)

O usuário pressionou um botão na notificação.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (notificationId: string, buttonIndex: number) => void

    • notificationId

      string

    • buttonIndex

      número

onClicked

browser.notifications.onClicked.addListener(
  callback: function,
)

O usuário clicou em uma área da notificação que não é um botão.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (notificationId: string) => void

    • notificationId

      string

onClosed

browser.notifications.onClosed.addListener(
  callback: function,
)

A notificação foi fechada pelo sistema ou por ação do usuário.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    (notificationId: string, byUser: boolean) => void

    • notificationId

      string

    • byUser

      booleano

onPermissionLevelChanged

browser.notifications.onPermissionLevelChanged.addListener(
  callback: function,
)

O usuário muda o nível de permissão. A partir do Chrome 47, apenas o ChromeOS tem uma interface que envia esse evento.

Parâmetros

onShowSettings

Descontinuado desde o Chrome 65
browser.notifications.onShowSettings.addListener(
  callback: function,
)

O botão de configurações de notificação personalizadas não está mais disponível.

O usuário clicou em um link para as configurações de notificação do app. A partir do Chrome 47, apenas o ChromeOS tem uma interface que envia esse evento. A partir do Chrome 65, essa interface também foi removida do ChromeOS.

Parâmetros

  • callback

    função

    O parâmetro callback é semelhante a: 

    () => void