browser.instanceID

Beschreibung

Verwenden Sie chrome.instanceID, um auf den Instanz-ID-Dienst zuzugreifen.

Berechtigungen

gcm

Verfügbarkeit

Chrome 44 und höher browser.* seit Chrome 148

Methoden

deleteID()

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

Setzt die App-Instanz-ID zurück und widerruft alle damit verknüpften Tokens.

Ausgabe

  • Promise<void>

    Chrome 96+ browser.* seit Chrome 148

    Wird aufgelöst, wenn der Löschvorgang abgeschlossen ist. Die Instanz-ID wurde erfolgreich widerrufen, wenn das Promise nicht abgelehnt wird.

deleteToken()

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

Widerruft ein gewährtes Token.

Parameter

  • deleteTokenParams

    Objekt

    Parameter für deleteToken.

    • authorizedEntity

      String

      Chrome 46 und höher browser.* seit Chrome 148

      Das autorisierte Rechtssubjekt, das zum Abrufen des Tokens verwendet wird.

    • Bereich

      String

      Chrome 46 und höher browser.* seit Chrome 148

      Der Bereich, der zum Abrufen des Tokens verwendet wird.

Ausgabe

  • Promise<void>

    Chrome 96+ browser.* seit Chrome 148

    Wird aufgelöst, wenn das Token gelöscht wurde. Das Token wurde erfolgreich widerrufen, wenn das Promise nicht abgelehnt wird.

getCreationTime()

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

Ruft den Zeitpunkt ab, zu dem die InstanceID generiert wurde. Die Erstellungszeit wird von callback zurückgegeben.

Ausgabe

  • Promise<number>

    Chrome 96+ browser.* seit Chrome 148

    Wird aufgelöst, wenn der Abruf abgeschlossen ist.

getID()

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

Ruft eine Kennung für die App-Instanz ab. Die Instanz-ID wird von callback zurückgegeben. Es wird dieselbe ID zurückgegeben, solange die Anwendungsidentität nicht widerrufen wurde oder abgelaufen ist.

Ausgabe

  • Promise<string>

    Chrome 96+ browser.* seit Chrome 148

    Wird aufgelöst, wenn der Abruf abgeschlossen ist.

getToken()

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

Gibt ein Token zurück, mit dem das autorisierte Rechtssubjekt auf den durch den Bereich definierten Dienst zugreifen kann.

Parameter

  • getTokenParams

    Objekt

    Parameter für getToken.

    • authorizedEntity

      String

      Chrome 46 und höher browser.* seit Chrome 148

      Gibt die Entität an, die berechtigt ist, auf Ressourcen zuzugreifen, die mit dieser Instanz-ID verknüpft sind. Dies kann eine Projekt-ID aus der Google Developer Console sein.

    • Optionen

      Objekt optional

      Chrome 46+ browser.* seit Chrome 148 Eingestellt seit Chrome 89

      -Optionen wurden verworfen und werden ignoriert.

      Ermöglicht das Einfügen einer kleinen Anzahl von String-Schlüssel/Wert-Paaren, die mit dem Token verknüpft werden und bei der Verarbeitung der Anfrage verwendet werden können.

    • Bereich

      String

      Chrome 46 und höher browser.* seit Chrome 148

      Gibt autorisierte Aktionen an, die das autorisierte Rechtssubjekt ausführen kann. Zum Senden von GCM-Nachrichten sollte beispielsweise der Bereich GCM verwendet werden.

Ausgabe

  • Promise<string>

    Chrome 96+ browser.* seit Chrome 148

    Wird aufgelöst, wenn der Abruf abgeschlossen ist.

Ereignisse

onTokenRefresh

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

Wird ausgelöst, wenn alle gewährten Tokens aktualisiert werden müssen.

Parameter

  • callback

    Funktion

    Der Parameter callback sieht so aus: 

    () => void