Struct ServiceWorkerHandle 

pub struct ServiceWorkerHandle {
    pub script_url: String,
    pub scope: String,
    pub closing: Arc<AtomicBool>,
    pub terminated: Arc<AtomicBool>,
    pub state: Arc<Mutex<ServiceWorkerRegistrationState>>,
    pub fetch_intercept_mode: Arc<Mutex<ServiceWorkerFetchInterceptMode>>,
    pub stealth_profile: Option<StealthProfile>,
}

A Send+Sync handle to a ServiceWorker’s lifecycle state.

Does NOT hold JSObject references — only atomic flags and IDs. This is safe to store across threads (unlike ServiceWorker DOM objects).

@trace REQ-BRW-004 [entity:ServiceWorker]

Fields

script_url: String

ServiceWorker script URL.

scope: String

Registration scope.

closing: Arc<AtomicBool>

Whether the ServiceWorker’s closing flag is set. Set by terminate() or when the registration is unregistered.

terminated: Arc<AtomicBool>

Whether the ServiceWorker thread has fully exited.

state: Arc<Mutex<ServiceWorkerRegistrationState>>

Current registration state.

fetch_intercept_mode: Arc<Mutex<ServiceWorkerFetchInterceptMode>>

Current fetch interception mode.

stealth_profile: Option<StealthProfile>

StealthProfile inherited from the registering page. Per DF-WK-10: “ServiceWorkerGlobalScope 首次解析 stealth getter → 按 D7 机制 从 bao-stealth REALM_PROFILES 继承注册页 profile” Per SPEC criterion #19: “SW 持久生命周期(跨页存活)下 profile 继承注册页且 terminate 后正确注销” @trace REQ-BRW-004 [entity:ServiceWorker] [criterion:19] DF-WK-10

Implementations

impl ServiceWorkerHandle

pub fn new( script_url: String, scope: String, stealth_profile: Option<StealthProfile>, ) -> Self

Create a new ServiceWorkerHandle in the installing state.

@trace REQ-BRW-004 [entity:ServiceWorker] DF-WK-8

pub fn id(&self) -> ServiceWorkerRegistrationId

Returns the ServiceWorkerRegistrationId for this handle.

@trace REQ-BRW-004 [entity:ServiceWorker]

pub fn is_closing(&self) -> bool

Returns true if the closing flag has been set.

@trace REQ-BRW-004 [entity:ServiceWorker]

pub fn is_terminated(&self) -> bool

Returns true if the ServiceWorker thread has fully exited.

@trace REQ-BRW-004 [entity:ServiceWorker]

pub fn registration_state(&self) -> ServiceWorkerRegistrationState

Returns the current registration state.

@trace REQ-BRW-004 [entity:ServiceWorker]

pub fn fetch_intercept_mode(&self) -> ServiceWorkerFetchInterceptMode

Returns the current fetch interception mode.

@trace REQ-BRW-004 [entity:ServiceWorker] [criterion:19]

pub fn is_intercepting_fetch(&self) -> bool

Returns true if the ServiceWorker is actively intercepting fetch requests.

@trace REQ-BRW-004 [entity:ServiceWorker] [criterion:19]

pub fn transition_state(&self, new_state: ServiceWorkerRegistrationState)

Transition the registration state to a new state.

Valid transitions: Installing → Installed → Activating → Activated → Redundant

@trace REQ-BRW-004 [entity:ServiceWorker] DF-WK-8

pub fn enable_fetch_interception(&self)

Enable fetch interception mode.

Called when the ServiceWorker becomes activated and starts intercepting fetch events within its scope. Per SPEC criterion #19, intercepted fetch requests MUST use the registering page’s stealth TLS/HTTP2 profile.

@trace REQ-BRW-004 [entity:ServiceWorker] [criterion:19]

pub fn disable_fetch_interception(&self)

Disable fetch interception mode.

Called when the ServiceWorker becomes redundant or is terminated. Per SPEC criterion #19: “terminate 后正确注销”.

@trace REQ-BRW-004 [entity:ServiceWorker] [criterion:19]

pub fn terminate(&self)

Signal the ServiceWorker to terminate. Idempotent — calling multiple times is safe.

@trace REQ-BRW-004 [entity:ServiceWorker]

pub fn mark_terminated(&self)

Mark the ServiceWorker as fully terminated (called after thread join).

@trace REQ-BRW-004 [entity:ServiceWorker]

Trait Implementations

impl Clone for ServiceWorkerHandle

fn clone(&self) -> ServiceWorkerHandle

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ServiceWorkerHandle

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.