dom / latest / fetchevent / replacesclientid.html /

FetchEvent.replacesClientId

The replacesClientId read-only property of the FetchEvent interface is the id of the client that is being replaced during a page navigation.

For example, when navigating from page A to page B replacesClientId is the ID of the client associated with page A. It can be an empty string when navigating from about:blank to another page, as about:blank's client will be reused, rather than be replaced.

Additionally, if the fetch isn't a navigation, replacesClientId will be an empty string. This could be used to access/communicate with a client that will imminently be replaced, right before a navigation.

Value

A DOMString.

Examples

self.addEventListener('fetch', function(event) {
  console.log(event.replacesClientId);
});

Specifications

Specification
Service Workers 1
# fetch-event-replacesClientId

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
replacesClientId
No
No
No
No
No
11.1
See bug 226638.
No
No
No
No
11.3
See bug 226638.
No

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/FetchEvent/replacesClientId

Name Web APIs
Version
Badge
Last Updated 2022-04-27T09:33:08Z