browser.instanceID

Description

Utilisez chrome.instanceID pour accéder au service Instance ID.

Autorisations

gcm

Disponibilité

Chrome 44+ browser.* depuis Chrome 148

Méthodes

deleteID()

browser.instanceID.deleteID(): Promise<void>

Réinitialise l'identifiant de l'instance d'application et révoque tous les jetons qui lui sont associés.

Renvoie

  • Promise<void>

    Chrome 96+ browser.* depuis Chrome 148

    Se résout lorsque la suppression est terminée. L'identifiant d'instance a bien été révoqué si la promesse n'est pas rejetée.

deleteToken()

browser.instanceID.deleteToken(
  deleteTokenParams: object,
): Promise<void>

Révoque un jeton accordé.

Paramètres

  • deleteTokenParams

    objet

    Paramètres de deleteToken.

    • authorizedEntity

      chaîne

      Chrome 46 ou version ultérieure browser.* depuis Chrome 148

      Entité autorisée utilisée pour obtenir le jeton.

    • champ d'application

      chaîne

      Chrome 46 ou version ultérieure browser.* depuis Chrome 148

      Champ d'application utilisé pour obtenir le jeton.

Renvoie

  • Promise<void>

    Chrome 96+ browser.* depuis Chrome 148

    Se résout lorsque la suppression du jeton est terminée. Le jeton a bien été révoqué si la promesse n'est pas rejetée.

getCreationTime()

browser.instanceID.getCreationTime(): Promise<number>

Récupère l'heure à laquelle l'InstanceID a été généré. L'heure de création sera renvoyée par callback.

Renvoie

  • Promise<number>

    Chrome 96+ browser.* depuis Chrome 148

    Se résout lorsque la récupération est terminée.

getID()

browser.instanceID.getID(): Promise<string>

Récupère un identifiant pour l'instance de l'application. L'ID d'instance sera renvoyé par callback. Le même ID sera renvoyé tant que l'identité de l'application n'aura pas été révoquée ou n'aura pas expiré.

Renvoie

  • Promise<string>

    Chrome 96+ browser.* depuis Chrome 148

    Se résout lorsque la récupération est terminée.

getToken()

browser.instanceID.getToken(
  getTokenParams: object,
): Promise<string>

Renvoie un jeton qui permet à l'entité autorisée d'accéder au service défini par le champ d'application.

Paramètres

  • getTokenParams

    objet

    Paramètres de getToken.

    • authorizedEntity

      chaîne

      Chrome 46 ou version ultérieure browser.* depuis Chrome 148

      Identifie l'entité autorisée à accéder aux ressources associées à cet ID d'instance. Il peut s'agir d'un ID de projet provenant de la console Google Developer.

    • options

      objet facultatif

      Chrome 46+ browser.* depuis Chrome 148 Obsolète depuis Chrome 89

      sont obsolètes et seront ignorées.

      Permet d'inclure un petit nombre de paires clé/valeur de chaîne qui seront associées au jeton et pourront être utilisées lors du traitement de la requête.

    • champ d'application

      chaîne

      Chrome 46 ou version ultérieure browser.* depuis Chrome 148

      Identifie les actions autorisées que l'entité autorisée peut effectuer. Par exemple, pour envoyer des messages GCM, le champ d'application GCM doit être utilisé.

Renvoie

  • Promise<string>

    Chrome 96+ browser.* depuis Chrome 148

    Se résout lorsque la récupération est terminée.

Événements

onTokenRefresh

browser.instanceID.onTokenRefresh.addListener(
  callback: function,
)

Déclenché lorsque tous les jetons accordés doivent être actualisés.

Paramètres

  • callback

    fonction

    Le paramètre callback se présente comme suit : 

    () => void