ServiceWorkerRegistration: active property

{{APIRef("Service Workers API")}}{{SecureContext_Header}} {{AvailableInWorkers}}

The active read-only property of the {{domxref("ServiceWorkerRegistration")}} interface returns a service worker whose {{domxref("ServiceWorker.state")}} is activating or activated. This property is initially set to null.

An active worker controls a {{domxref("Client")}} if the client's URL falls within the scope of the registration (the scope option set when {{domxref("ServiceWorkerContainer.register")}} is first called.)

[!NOTE] Once an active worker is activating, neither a runtime script error nor a force termination of the active worker prevents the active worker from getting activated.

Value

A {{domxref("ServiceWorker")}} object's property, if it is currently in an activating or activated state.

Specifications

{{Specifications}}

Browser compatibility

{{Compat}}

See also

• Using Service Workers
• Service workers basic code example
• Using web workers