chrome.gcm

Descrição

Use chrome.gcm para permitir que apps e extensões enviem e recebam mensagens pelo Firebase Cloud Messaging (FCM).

Permissões

gcm

Propriedades

MAX_MESSAGE_SIZE

O tamanho máximo (em bytes) de todos os pares de chave-valor em uma mensagem.

Valor

4096

Métodos

register()

Promessa 
chrome.gcm.register(
  senderIds: string[],
  callback?: function,
)

Registra o aplicativo no FCM. O ID de registro vai ser retornado pelo callback. Se register for chamado novamente com a mesma lista de senderIds, o mesmo ID de registro será retornado.

Parâmetros

  • senderIds

    string[]

    Uma lista de IDs de servidor que têm permissão para enviar mensagens ao aplicativo. Ele deve conter no mínimo um e no máximo 100 IDs de remetente.

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (registrationId: string) => void

    • registrationId

      string

      Um código de registro atribuído ao aplicativo pelo FCM.

Retorna

  • Promessa<string>

    Chrome 116 ou versões mais recentes

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

send()

Promessa 
chrome.gcm.send(
  message: object,
  callback?: function,
)

Envia uma mensagem de acordo com o conteúdo.

Parâmetros

  • mensagem

    objeto

    Uma mensagem para enviar à outra parte pelo FCM.

    • dados

      objeto

      Dados de mensagens a serem enviados ao servidor. goog. e google que não diferenciam maiúsculas de minúsculas, assim como collapse_key que diferencia maiúsculas de minúsculas não são permitidos como prefixos de chave. A soma de todos os pares de chave-valor não pode exceder gcm.MAX_MESSAGE_SIZE.

    • destinationId

      string

      O ID do servidor que receberá a mensagem, conforme atribuído pelo Console de APIs do Google.

    • messageId

      string

      O ID da mensagem. Ele precisa ser exclusivo para cada mensagem no escopo dos aplicativos. Consulte a documentação do Cloud Messaging para saber como escolher e gerenciar um ID.

    • timeToLive

      número opcional

      Time to live da mensagem em segundos. Se não for possível enviar a mensagem nesse período, um evento onSendError será gerado. Um time to live de 0 indica que a mensagem deve ser enviada imediatamente ou falhar se não for possível. O valor padrão do time to live é 86.400 segundos (1 dia) e o valor máximo é 2.419.200 segundos (28 dias).

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    (messageId: string) => void

    • messageId

      string

      O ID da mensagem para a qual a chamada de retorno foi emitida.

Retorna

  • Promessa<string>

    Chrome 116 ou versões mais recentes

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

unregister()

Promessa 
chrome.gcm.unregister(
  callback?: function,
)

Cancela o registro do aplicativo no FCM.

Parâmetros

  • callback

    função opcional

    O parâmetro callback tem esta aparência: 

    () => void

Retorna

  • Promessa<void>

    Chrome 116 ou versões mais recentes

    O Manifesto V3 e versões mais recentes oferecem suporte a promessas, mas callbacks são fornecidos para a compatibilidade com versões anteriores. Não é possível usar ambos na mesma chamada de função. A promessa é resolvida com o mesmo tipo passado ao retorno de chamada.

Eventos

onMessage

chrome.gcm.onMessage.addListener(
  callback: function,
)

Disparado quando uma mensagem é recebida pelo FCM.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (message: object) => void

    • mensagem

      objeto

      • collapseKey

        string opcional

        A chave de recolhimento de uma mensagem. Consulte Mensagens não recolhíveis e recolhíveis para mais detalhes.

      • dados

        objeto

        Os dados da mensagem.

      • de

        string opcional

        O remetente que emitiu a mensagem.

onMessagesDeleted

chrome.gcm.onMessagesDeleted.addListener(
  callback: function,
)

Disparado quando um servidor do FCM precisa excluir mensagens enviadas por um servidor de apps para o aplicativo. Consulte Duração de uma mensagem para detalhes sobre como lidar com esse evento.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    () => void

onSendError

chrome.gcm.onSendError.addListener(
  callback: function,
)

Disparado quando não foi possível enviar uma mensagem ao servidor do FCM.

Parâmetros

  • callback

    função

    O parâmetro callback tem esta aparência: 

    (error: object) => void

    • erro

      objeto

      • detalhes

        objeto

        Outros detalhes relacionados ao erro, quando disponíveis.

      • errorMessage

        string

        A mensagem de erro que descreve o problema.

      • messageId

        string opcional

        O ID da mensagem com esse erro, se ele estiver relacionado a uma mensagem específica.