Welcome What's new in Chrome extensions API reference Samples
Welcome What's new in Chrome extensions API reference Samples

chrome.instanceID

  • Description

    Use chrome.instanceID to access the Instance ID service.

  • Permissions
    gcm
  • Availability
    Chrome 44+

Summary

Methods

deleteID

chrome.instanceID.deleteID(
  callback?: function,
)
Promise

Resets the app instance identifier and revokes all tokens associated with it.

Parameters

  • callback

    function optional

    The callback parameter looks like: () => void

Returns

  • Promise<void>

    Chrome 96+

    Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback.

deleteToken

chrome.instanceID.deleteToken(
  deleteTokenParams: object,
  callback?: function,
)
Promise

Revokes a granted token.

Parameters

  • deleteTokenParams

    object

    Parameters for deleteToken.

    • authorizedEntity

      string

      Chrome 46+

      The authorized entity that is used to obtain the token.

    • scope

      string

      Chrome 46+

      The scope that is used to obtain the token.

  • callback

    function optional

    The callback parameter looks like: () => void

Returns

  • Promise<void>

    Chrome 96+

    Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback.

getCreationTime

chrome.instanceID.getCreationTime(
  callback?: function,
)
Promise

Retrieves the time when the InstanceID has been generated. The creation time will be returned by the callback.

Parameters

  • callback

    function optional

    The callback parameter looks like: (creationTime: number) => void

    • creationTime

      number

      The time when the Instance ID has been generated, represented in milliseconds since the epoch.

Returns

  • Promise<number>

    Chrome 96+

    Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback.

getID

chrome.instanceID.getID(
  callback?: function,
)
Promise

Retrieves an identifier for the app instance. The instance ID will be returned by the callback. The same ID will be returned as long as the application identity has not been revoked or expired.

Parameters

  • callback

    function optional

    The callback parameter looks like: (instanceID: string) => void

    • instanceID

      string

      An Instance ID assigned to the app instance.

Returns

  • Promise<string>

    Chrome 96+

    Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback.

getToken

chrome.instanceID.getToken(
  getTokenParams: object,
  callback?: function,
)
Promise

Return a token that allows the authorized entity to access the service defined by scope.

Parameters

  • getTokenParams

    object

    Parameters for getToken.

    • authorizedEntity

      string

      Chrome 46+

      Identifies the entity that is authorized to access resources associated with this Instance ID. It can be a project ID from Google developer console.

    • options

      object optional

      Chrome 46+ Deprecated since Chrome 89

      options are deprecated and will be ignored.

      Allows including a small number of string key/value pairs that will be associated with the token and may be used in processing the request.

    • scope

      string

      Chrome 46+

      Identifies authorized actions that the authorized entity can take. E.g. for sending GCM messages, GCM scope should be used.

  • callback

    function optional

    The callback parameter looks like: (token: string) => void

    • token

      string

      A token assigned by the requested service.

Returns

  • Promise<string>

    Chrome 96+

    Promises are supported in Manifest V3 and later, but callbacks are provided for backward compatibility. You cannot use both on the same function call. The promise resolves with the same type that is passed to the callback.

Events

onTokenRefresh

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

Fired when all the granted tokens need to be refreshed.

Parameters

  • callback

    function

    The callback parameter looks like: () => void

This site uses cookies to deliver and enhance the quality of its services and to analyze traffic. If you agree, cookies are also used to serve advertising and to personalize the content and advertisements that you see. Learn more about our use of cookies.