PushManager: registrations() 方法

已弃用: 此功能不再推荐使用。尽管一些浏览器可能仍然支持它,但它可能已被从相关的 Web 标准中删除,可能正在被删除,或者可能只保留为了兼容性目的。避免使用它,并尽可能更新现有代码;请查看本页底部的兼容性表,以指导您的决定。请注意,此功能可能随时停止工作。

非标准: 此功能是非标准的,不在标准化轨道上。不要在面向 Web 的生产网站上使用它:它不会为每个用户工作。实现之间也可能存在很大的不兼容性,并且行为可能在将来发生变化。

注意: 此功能在Web Workers中可用。

registrations 方法用于向系统询问现有的推送端点注册情况。

注意: 此方法已被PushManager.getSubscription() 方法取代。

语法

js
registrations()

参数

无。

返回值

一个 DOMRequest 对象,用于处理方法调用的成功或失败。

如果方法调用成功,则请求的 result 将是一个PushRegistration 对象数组。

PushRegistration

这些对象是具有以下属性的匿名 JavaScript 对象

pushEndpoint

表示端点 URL 的字符串。

version

推送端点所在的当前版本。

示例

js
const req = navigator.push.registrations();

req.onsuccess = (e) => {
  if (req.result.length > 0) {
    req.result.forEach((result) => {
      console.log(
        `Existing registration ${result.pushEndpoint} ${result.version}`,
      );
    });
    // Reuse existing endpoints.
  } else {
    // Register for a new endpoint.
    const register = navigator.push.register();
    register.onsuccess = (e) => {
      console.log(`Registered new endpoint: ${register.result}`);
    };
  }
};

规范

此功能不再是任何规范的一部分。它不再是成为标准的轨道。

浏览器兼容性

BCD 表仅在浏览器中加载

另请参阅