Class: ServiceWorkers

Class: ServiceWorkers

Query and receive events from a sessions active service workers.

Process: Main
This class is not exported from the 'electron' module. It is only available as a return value of other methods in the Electron API.

Instances of the ServiceWorkers class are accessed by using serviceWorkers property of a Session.

For example:

  1. const { session } = require('electron')
  2. // Get all service workers.
  3. console.log(session.defaultSession.serviceWorkers.getAllRunning())
  4. // Handle logs and get service worker info
  5. session.defaultSession.serviceWorkers.on('console-message', (event, messageDetails) => {
  6. console.log(
  7. 'Got service worker message',
  8. messageDetails,
  9. 'from',
  10. session.defaultSession.serviceWorkers.getFromVersionID(messageDetails.versionId)
  11. )
  12. })

Instance Events

The following events are available on instances of ServiceWorkers:

Event: ‘console-message’

Returns:

  • event Event
  • messageDetails Object - Information about the console message
    • message String - The actual console message
    • versionId Number - The version ID of the service worker that sent the log message
    • source String - The type of source for this message. Can be javascript, xml, network, console-api, storage, app-cache, rendering, security, deprecation, worker, violation, intervention, recommendation or other.
    • level Number - The log level, from 0 to 3. In order it matches verbose, info, warning and error.
    • sourceUrl String - The URL the message came from
    • lineNumber Number - The line number of the source that triggered this console message

Emitted when a service worker logs something to the console.

Event: ‘registration-completed’

Returns:

  • event Event
  • details Object - Information about the registered service worker
    • scope String - The base URL that a service worker is registered for

Emitted when a service worker has been registered. Can occur after a call to navigator.serviceWorker.register(‘/sw.js’) successfully resolves or when a Chrome extension is loaded.

Instance Methods

The following methods are available on instances of ServiceWorkers:

serviceWorkers.getAllRunning()

Returns Record<Number, ServiceWorkerInfo> - A ServiceWorkerInfo object where the keys are the service worker version ID and the values are the information about that service worker.

serviceWorkers.getFromVersionID(versionId)

  • versionId Number

Returns ServiceWorkerInfo - Information about this service worker

If the service worker does not exist or is not running this method will throw an exception.