Interface DedicatedWorkerGlobalScope

(the Worker global scope) is accessible through the self keyword. Some additional global functions, namespaces objects, and constructors, not typically associated with the worker global scope, but available on it, are listed in the JavaScript Reference. See also: Functions available to workers.

interface DedicatedWorkerGlobalScope {
    caches: CacheStorage;
    crossOriginIsolated: boolean;
    crypto: Crypto;
    fonts: FontFaceSet;
    indexedDB: IDBFactory;
    isSecureContext: boolean;
    location: WorkerLocation;
    name: string;
    navigator: WorkerNavigator;
    onerror: (this: WorkerGlobalScope, ev: ErrorEvent) => any;
    onlanguagechange: (this: WorkerGlobalScope, ev: Event) => any;
    onmessage: (this: DedicatedWorkerGlobalScope, ev: MessageEvent) => any;
    onmessageerror: (this: DedicatedWorkerGlobalScope, ev: MessageEvent) => any;
    onoffline: (this: WorkerGlobalScope, ev: Event) => any;
    ononline: (this: WorkerGlobalScope, ev: Event) => any;
    onrejectionhandled: (
        this: WorkerGlobalScope,
        ev: PromiseRejectionEvent,
    ) => any;
    onrtctransform: (
        this: DedicatedWorkerGlobalScope,
        ev: RTCTransformEvent,
    ) => any;
    onunhandledrejection: (
        this: WorkerGlobalScope,
        ev: PromiseRejectionEvent,
    ) => any;
    origin: string;
    performance: Performance;
    self: WorkerGlobalScope & typeof globalThis;
    addEventListener<K extends keyof DedicatedWorkerGlobalScopeEventMap>(
        type: K,
        listener: (
            this: DedicatedWorkerGlobalScope,
            ev: DedicatedWorkerGlobalScopeEventMap[K],
        ) => any,
        options?: boolean | AddEventListenerOptions,
    ): void;
    addEventListener(
        type: string,
        listener: EventListenerOrEventListenerObject,
        options?: boolean | AddEventListenerOptions,
    ): void;
    atob(data: string): string;
    btoa(data: string): string;
    cancelAnimationFrame(handle: number): void;
    clearInterval(id: number): void;
    clearTimeout(id: number): void;
    close(): void;
    createImageBitmap(
        image: ImageBitmapSource,
        options?: ImageBitmapOptions,
    ): Promise<ImageBitmap>;
    createImageBitmap(
        image: ImageBitmapSource,
        sx: number,
        sy: number,
        sw: number,
        sh: number,
        options?: ImageBitmapOptions,
    ): Promise<ImageBitmap>;
    dispatchEvent(event: Event): boolean;
    fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>;
    importScripts(...urls: (string | URL)[]): void;
    postMessage(message: any, transfer: Transferable[]): void;
    postMessage(message: any, options?: StructuredSerializeOptions): void;
    queueMicrotask(callback: VoidFunction): void;
    removeEventListener<K extends keyof DedicatedWorkerGlobalScopeEventMap>(
        type: K,
        listener: (
            this: DedicatedWorkerGlobalScope,
            ev: DedicatedWorkerGlobalScopeEventMap[K],
        ) => any,
        options?: boolean | EventListenerOptions,
    ): void;
    removeEventListener(
        type: string,
        listener: EventListenerOrEventListenerObject,
        options?: boolean | EventListenerOptions,
    ): void;
    reportError(e: any): void;
    requestAnimationFrame(callback: FrameRequestCallback): number;
    setInterval(
        handler: TimerHandler,
        timeout?: number,
        ...arguments: any[],
    ): number;
    setTimeout(
        handler: TimerHandler,
        timeout?: number,
        ...arguments: any[],
    ): number;
    structuredClone<T = any>(value: T, options?: StructuredSerializeOptions): T;
}

Hierarchy

WorkerGlobalScope
AnimationFrameProvider
- DedicatedWorkerGlobalScope (View Summary)

Properties

`Readonly`caches

caches: CacheStorage

Available only in secure contexts.

`Readonly`crossOriginIsolated

crossOriginIsolated: boolean

`Readonly`crypto

crypto: Crypto

`Readonly`fonts

fonts: FontFaceSet

`Readonly`indexedDB

indexedDB: IDBFactory

`Readonly`isSecureContext

isSecureContext: boolean

`Readonly`location

location: WorkerLocation

Returns workerGlobal's WorkerLocation object.

`Readonly`name

name: string

Returns dedicatedWorkerGlobal's name, i.e. the value given to the Worker constructor. Primarily useful for debugging.

`Readonly`navigator

navigator: WorkerNavigator

Returns workerGlobal's WorkerNavigator object.

onerror

onerror: (this: WorkerGlobalScope, ev: ErrorEvent) => any

onlanguagechange

onlanguagechange: (this: WorkerGlobalScope, ev: Event) => any

onmessage

onmessage: (this: DedicatedWorkerGlobalScope, ev: MessageEvent) => any

onmessageerror

onmessageerror: (this: DedicatedWorkerGlobalScope, ev: MessageEvent) => any

onoffline

onoffline: (this: WorkerGlobalScope, ev: Event) => any

ononline

ononline: (this: WorkerGlobalScope, ev: Event) => any

onrejectionhandled

onrejectionhandled: (this: WorkerGlobalScope, ev: PromiseRejectionEvent) => any

onrtctransform

onrtctransform: (this: DedicatedWorkerGlobalScope, ev: RTCTransformEvent) => any

onunhandledrejection

onunhandledrejection: (
this: WorkerGlobalScope,
ev: PromiseRejectionEvent,
) => any

`Readonly`origin

origin: string

`Readonly`performance

performance: Performance

`Readonly`self

self: WorkerGlobalScope & typeof globalThis

Returns workerGlobal.

Methods

addEventListener

addEventListener<K extends keyof DedicatedWorkerGlobalScopeEventMap>(
    type: K,
    listener: (
        this: DedicatedWorkerGlobalScope,
        ev: DedicatedWorkerGlobalScopeEventMap[K],
    ) => any,
    options?: boolean | AddEventListenerOptions,
): void
Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.

When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in § 2.8 Observing event listeners.

When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

MDN Reference
Type Parameters
- K extends keyof DedicatedWorkerGlobalScopeEventMap
Parameters
- type: K
- listener: (
  this: DedicatedWorkerGlobalScope,
  ev: DedicatedWorkerGlobalScopeEventMap[K],
  ) => any
- Optionaloptions: boolean | AddEventListenerOptions
Returns void
Overrides WorkerGlobalScope.addEventListener
addEventListener(
    type: string,
    listener: EventListenerOrEventListenerObject,
    options?: boolean | AddEventListenerOptions,
): void
Appends an event listener for events whose type attribute value is type. The callback argument sets the callback that will be invoked when the event is dispatched.

The options argument sets listener-specific options. For compatibility this can be a boolean, in which case the method behaves exactly as if the value was specified as options's capture.

When set to true, options's capture prevents callback from being invoked when the event's eventPhase attribute value is BUBBLING_PHASE. When false (or not present), callback will not be invoked when event's eventPhase attribute value is CAPTURING_PHASE. Either way, callback will be invoked if event's eventPhase attribute value is AT_TARGET.

When set to true, options's passive indicates that the callback will not cancel the event by invoking preventDefault(). This is used to enable performance optimizations described in § 2.8 Observing event listeners.

When set to true, options's once indicates that the callback will only be invoked once after which the event listener will be removed.

If an AbortSignal is passed for options's signal, then the event listener will be removed when signal is aborted.

The event listener is appended to target's event listener list and is not appended if it has the same type, callback, and capture.

MDN Reference
Parameters
- type: string
- listener: EventListenerOrEventListenerObject
- Optionaloptions: boolean | AddEventListenerOptions
Returns void
Overrides WorkerGlobalScope.addEventListener

atob

atob(data: string): string
MDN Reference
Parameters
- data: string
Returns string
Inherited from WorkerGlobalScope.atob

btoa

btoa(data: string): string
MDN Reference
Parameters
- data: string
Returns string
Inherited from WorkerGlobalScope.btoa

cancelAnimationFrame

cancelAnimationFrame(handle: number): void
MDN Reference
Parameters
- handle: number
Returns void
Inherited from AnimationFrameProvider.cancelAnimationFrame

clearInterval

clearInterval(id: number): void
MDN Reference
Parameters
- id: number
Returns void
Inherited from WorkerGlobalScope.clearInterval

clearTimeout

clearTimeout(id: number): void
MDN Reference
Parameters
- id: number
Returns void
Inherited from WorkerGlobalScope.clearTimeout

close

close(): void
Aborts dedicatedWorkerGlobal.

MDN Reference

Returns void

createImageBitmap

createImageBitmap(
image: ImageBitmapSource,
options?: ImageBitmapOptions,
): Promise<ImageBitmap>
MDN Reference
Parameters
- image: ImageBitmapSource
- Optionaloptions: ImageBitmapOptions
Returns Promise<ImageBitmap>
Inherited from WorkerGlobalScope.createImageBitmap
createImageBitmap(
    image: ImageBitmapSource,
    sx: number,
    sy: number,
    sw: number,
    sh: number,
    options?: ImageBitmapOptions,
): Promise<ImageBitmap>
Parameters
- image: ImageBitmapSource
- sx: number
- sy: number
- sw: number
- sh: number
- Optionaloptions: ImageBitmapOptions
Returns Promise<ImageBitmap>
Inherited from WorkerGlobalScope.createImageBitmap

dispatchEvent

dispatchEvent(event: Event): boolean
Dispatches a synthetic event event to target and returns true if either event's cancelable attribute value is false or its preventDefault() method was not invoked, and false otherwise.

MDN Reference
Parameters
- event: Event
Returns boolean
Inherited from WorkerGlobalScope.dispatchEvent

fetch

fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>
MDN Reference
Parameters
- input: RequestInfo | URL
- Optionalinit: RequestInit
Returns Promise<Response>
Inherited from WorkerGlobalScope.fetch

importScripts

importScripts(...urls: (string | URL)[]): void
Fetches each URL in urls, executes them one-by-one in the order they are passed, and then returns (or throws if something went amiss).

MDN Reference
Parameters
- ...urls: (string | URL)[]
Returns void
Inherited from WorkerGlobalScope.importScripts

postMessage

postMessage(message: any, transfer: Transferable[]): void
Clones message and transmits it to the Worker object associated with dedicatedWorkerGlobal. transfer can be passed as a list of objects that are to be transferred rather than cloned.

MDN Reference
Parameters
- message: any
- transfer: Transferable[]
Returns void
postMessage(message: any, options?: StructuredSerializeOptions): void
Parameters
- message: any
- Optionaloptions: StructuredSerializeOptions
Returns void

queueMicrotask

queueMicrotask(callback: VoidFunction): void
MDN Reference
Parameters
- callback: VoidFunction
Returns void
Inherited from WorkerGlobalScope.queueMicrotask

removeEventListener

removeEventListener<K extends keyof DedicatedWorkerGlobalScopeEventMap>(
    type: K,
    listener: (
        this: DedicatedWorkerGlobalScope,
        ev: DedicatedWorkerGlobalScopeEventMap[K],
    ) => any,
    options?: boolean | EventListenerOptions,
): void
Removes the event listener in target's event listener list with the same type, callback, and options.

MDN Reference
Type Parameters
- K extends keyof DedicatedWorkerGlobalScopeEventMap
Parameters
- type: K
- listener: (
  this: DedicatedWorkerGlobalScope,
  ev: DedicatedWorkerGlobalScopeEventMap[K],
  ) => any
- Optionaloptions: boolean | EventListenerOptions
Returns void
Overrides WorkerGlobalScope.removeEventListener
removeEventListener(
    type: string,
    listener: EventListenerOrEventListenerObject,
    options?: boolean | EventListenerOptions,
): void
Removes the event listener in target's event listener list with the same type, callback, and options.

MDN Reference
Parameters
- type: string
- listener: EventListenerOrEventListenerObject
- Optionaloptions: boolean | EventListenerOptions
Returns void
Overrides WorkerGlobalScope.removeEventListener

reportError

reportError(e: any): void
MDN Reference
Parameters
- e: any
Returns void
Inherited from WorkerGlobalScope.reportError

requestAnimationFrame

requestAnimationFrame(callback: FrameRequestCallback): number
MDN Reference
Parameters
- callback: FrameRequestCallback
Returns number
Inherited from AnimationFrameProvider.requestAnimationFrame

setInterval

setInterval(
    handler: TimerHandler,
    timeout?: number,
    ...arguments: any[],
): number
MDN Reference
Parameters
- handler: TimerHandler
- Optionaltimeout: number
- ...arguments: any[]
Returns number
Inherited from WorkerGlobalScope.setInterval

setTimeout

setTimeout(handler: TimerHandler, timeout?: number, ...arguments: any[]): number
MDN Reference
Parameters
- handler: TimerHandler
- Optionaltimeout: number
- ...arguments: any[]
Returns number
Inherited from WorkerGlobalScope.setTimeout

structuredClone

structuredClone<T = any>(value: T, options?: StructuredSerializeOptions): T
MDN Reference
Type Parameters
- T = any
Parameters
- value: T
- Optionaloptions: StructuredSerializeOptions
Returns T
Inherited from WorkerGlobalScope.structuredClone