跳至主要內容

類別:ServiceWorkers

類別:ServiceWorkers

查詢並接收來自工作階段中作用的 Service Workers 的事件。

程序:
此類別並非從 'electron' 模組匯出。它僅能作為 Electron API 中其他方法的回傳值使用。

ServiceWorkers 類別的實例是透過使用 SessionserviceWorkers 屬性來存取。

例如

const { session } = require('electron')

// Get all service workers.
console.log(session.defaultSession.serviceWorkers.getAllRunning())

// Handle logs and get service worker info
session.defaultSession.serviceWorkers.on('console-message', (event, messageDetails) => {
console.log(
'Got service worker message',
messageDetails,
'from',
session.defaultSession.serviceWorkers.getFromVersionID(messageDetails.versionId)
)
})

實例事件

以下事件可在 ServiceWorkers 的實例上使用

事件:'console-message'

回傳

  • event 事件
  • messageDetails 物件 - 關於主控台訊息的資訊
    • message 字串 - 實際的主控台訊息
    • versionId 數字 - 發送記錄訊息的 Service Worker 版本 ID
    • source 字串 - 此訊息的來源類型。可以是 javascriptxmlnetworkconsole-apistoragerenderingsecuritydeprecationworkerviolationinterventionrecommendationother
    • level 數字 - 記錄層級,從 0 到 3。依序對應 verboseinfowarningerror
    • sourceUrl 字串 - 訊息的來源 URL
    • lineNumber 數字 - 觸發此主控台訊息的來源行號

當 Service Worker 將內容記錄到主控台時發出。

事件:'registration-completed'

回傳

  • event 事件
  • details 物件 - 關於已註冊 Service Worker 的資訊
    • scope 字串 - 註冊 Service Worker 的基本 URL

當 Service Worker 已註冊時發出。在呼叫 navigator.serviceWorker.register('/sw.js') 成功解析或載入 Chrome 擴充功能時可能會發生。

實例方法

以下方法可在 ServiceWorkers 的實例上使用

serviceWorkers.getAllRunning()

回傳 Record<number, ServiceWorkerInfo> - ServiceWorkerInfo 物件,其中索引鍵是 Service Worker 版本 ID,而值是關於該 Service Worker 的資訊。

serviceWorkers.getFromVersionID(versionId)

  • versionId 數字

回傳 ServiceWorkerInfo - 關於此 Service Worker 的資訊

如果 Service Worker 不存在或未執行,此方法將擲回例外狀況。