Clients: get() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since April 2018.

Note: This feature is only available in Service Workers.

The get() method of the Clients interface gets a service worker client matching a given id and returns it in a Promise.

Syntax

js
get(id)

Parameters

id

A string representing the id of the client you want to get.

Return value

A Promise that resolves to a Client object or undefined.

Examples

js
self.clients.get(id).then((client) => {
  self.clients.openWindow(client.url);
});

Specifications

Specification
Service Workers
# clients-get

Browser compatibility

desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
get