Clients

Experimental: 這是一個實驗中的功能
此功能在某些瀏覽器尚在開發中,請參考兼容表格以得到不同瀏覽器用的前輟。

The Clients interface of the Service Workers API (en-US) represents a container for a list of Client (en-US) objects.

Methods

Clients.get() (en-US)

Gets a service worker client matching a given id and returns it in a Promise.

Clients.matchAll() (en-US)

Gets a list of service worker clients and returns them in a Promise. Include the options parameter to return all service worker clients whose origin is the same as the associated service worker's origin. If options are not included, the method returns only the service worker clients controlled by the service worker.

Clients.openWindow() (en-US)

Opens a service worker Client (en-US) in a new browser window.

Clients.claim() (en-US)

Allows an active Service Worker to set itself as the active worker for a client page when the worker and the page are in the same scope.

Examples

clients.matchAll(options).then(function(clients) {
  for(i = 0 ; i < clients.length ; i++) {
    if(clients[i] === 'index.html') {
      clients.openWindow(clients[i]);
      // or do something else involving the matching client
    }
  }
});

Specifications

Specification
Service Workers
# clients-interface

Browser compatibility

BCD tables only load in the browser

See also