说明
使用 chrome.instanceID 访问 Instance ID 服务。
权限
gcm可用性
Chrome 44 及更高版本
browser.*（自 Chrome 148 起）
方法
deleteID()
browser.instanceID.deleteID(): Promise<void>
重置应用实例标识符，并撤消与其关联的所有令牌。
返回
-
承诺<void>
Chrome 96 及更高版本 browser.*（自 Chrome 148 起）在删除操作完成后解析。如果 promise 未拒绝，则表示实例标识符已成功撤消。
deleteToken()
browser.instanceID.deleteToken(
deleteTokenParams: object,
): Promise<void>
撤消已授予的令牌。
参数
-
deleteTokenParams
对象
deleteToken 的参数。
-
authorizedEntity
字符串
Chrome 46 及更高版本 browser.*（自 Chrome 148 起）用于获取令牌的已获授权的实体。
-
范围
字符串
Chrome 46 及更高版本 browser.*（自 Chrome 148 起）用于获取令牌的范围。
-
返回
-
承诺<void>
Chrome 96 及更高版本 browser.*（自 Chrome 148 起）在令牌删除完成后解析。如果 promise 未拒绝，则表示令牌已成功撤消。
getCreationTime()
browser.instanceID.getCreationTime(): Promise<number>
检索 InstanceID 的生成时间。创建时间将由 callback 返回。
返回
-
<number>
Chrome 96 及更高版本 browser.*（自 Chrome 148 起）在检索完成时解析。
getID()
browser.instanceID.getID(): Promise<string>
检索应用实例的标识符。实例 ID 将由 callback 返回。只要应用身份未被撤消或过期，就会返回相同的 ID。
返回
-
Promise<string>
Chrome 96 及更高版本 browser.*（自 Chrome 148 起）在检索完成时解析。
getToken()
browser.instanceID.getToken(
getTokenParams: object,
): Promise<string>
返回一个令牌，允许已获授权的实体访问由 scope 定义的服务。
参数
-
getTokenParams
对象
getToken 的参数。
-
authorizedEntity
字符串
Chrome 46 及更高版本 browser.*（自 Chrome 148 起）标识有权访问与此实例 ID 关联的资源的实体。它可以是 Google 开发者控制台中的项目 ID。
-
选项
对象（可选）
Chrome 46 及更高版本 browser.*（自 Chrome 148 起） 自 Chrome 89 起已弃用选项已被弃用，将被忽略。
允许包含少量字符串键值对，这些键值对将与令牌相关联，并可用于处理请求。
-
范围
字符串
Chrome 46 及更高版本 browser.*（自 Chrome 148 起）标识已获授权的实体可以执行的授权操作。例如，如需发送 GCM 消息，应使用
GCM范围。
-
返回
-
Promise<string>
Chrome 96 及更高版本 browser.*（自 Chrome 148 起）在检索完成时解析。
事件
onTokenRefresh
browser.instanceID.onTokenRefresh.addListener(
callback: function,
)
在需要刷新所有已授予的令牌时触发。
参数
-
callback
函数
callback参数如下所示：() => void