PushManager: registrations() 方法

已棄用:此特性不再推薦。雖然某些瀏覽器可能仍然支援它,但它可能已經從相關的網路標準中刪除,可能正在刪除過程中,或者可能僅為相容性目的而保留。請避免使用它,如果可能,請更新現有程式碼;請參閱本頁底部的相容性表格以指導您的決策。請注意,此特性可能隨時停止工作。

非標準:此特性未標準化。我們不建議在生產環境中使用非標準特性,因為它們瀏覽器支援有限,並且可能會更改或被移除。但是,在沒有標準選項的特定情況下,它們可以是合適的替代方案。

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

registrations 方法用於查詢系統關於現有推送端點註冊的資訊。

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

語法

js
registrations()

引數

無。

返回值

一個 DOMRequest 物件,用於處理方法呼叫的成功或失敗。

如果方法呼叫成功,請求的 result 將是一個 PushRegistration 物件陣列。

PushRegistration

這些物件是具有以下屬性的匿名 JavaScript 物件

pushEndpoint

一個表示端點 URL 的字串。

版本

推送端點的當前版本。

示例

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}`);
    };
  }
};

規範

此功能不再是任何規範的一部分。它已不再有望成為標準。

瀏覽器相容性

另見