DedicatedWorkerGlobalScope

The DedicatedWorkerGlobalScope object (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.

Properties

This interface inherits properties from the WorkerGlobalScope interface, and its parent EventTarget, and therefore implements properties from WindowTimers, WindowBase64, and WindowEventHandlers.

Properties inherited from WorkerGlobalScope

WorkerGlobalScope.self

Returns an object reference to the DedicatedWorkerGlobalScope object itself.

WorkerGlobalScope.console Read only

Returns the Console associated with the worker.

WorkerGlobalScope.location Read only

Returns the WorkerLocation associated with the worker. WorkerLocation is a specific location object, mostly a subset of the Location for browsing scopes, but adapted to workers.

WorkerGlobalScope.navigator Read only

Returns the WorkerNavigator associated with the worker. WorkerNavigator is a specific navigator object, mostly a subset of the Navigator for browsing scopes, but adapted to workers.

WorkerGlobalScope.performance Read only

Returns the Performance object associated with the worker, which is a regular performance object, but with a subset of its properties and methods available.

Event handlers

This interface inherits event handlers from the WorkerGlobalScope interface, and its parent EventTarget, and therefore implements event handlers from WindowTimers, WindowBase64, and WindowEventHandlers.

DedicatedWorkerGlobalScope.onmessage

Is an EventHandler representing the code to be called when the message event is raised. These events are of type MessageEvent and will be called when the worker receives a message from the document that started it (i.e. from the Worker.postMessage method.)

Methods

This interface inherits methods from the WorkerGlobalScope interface, and its parent EventTarget, and therefore implements methods from WindowTimers, WindowBase64, and WindowEventHandlers.

DedicatedWorkerGlobalScope.postMessage

Sends a message — which can consist of any JavaScript object — to the parent document that first spawned the worker.

Inherited from WorkerGlobalScope

WorkerGlobalScope.close()

Discards any tasks queued in the WorkerGlobalScope's event loop, effectively closing this particular scope.

WorkerGlobalScope.dump()

Writes a message to the console.

WorkerGlobalScope.importScripts()

Imports one or more scripts into the worker's scope. You can specify as many as you'd like, separated by commas. For example: importScripts('foo.js', 'bar.js');

Implemented from other places

WindowBase64.atob()

Decodes a string of data which has been encoded using base-64 encoding.

WindowBase64.btoa()

Creates a base-64 encoded ASCII string from a string of binary data.

WindowTimers.clearInterval()

Cancels the repeated execution set using WindowTimers.setInterval().

WindowTimers.clearTimeout()

Cancels the repeated execution set using WindowTimers.setTimeout().

WindowTimers.setInterval()

Schedules the execution of a function every X milliseconds.

WindowTimers.setTimeout()

Sets a delay for executing a function.

Specifications

Specification	Status	Comment
WHATWG HTML Living Standard The definition of 'DedicatedWorkerGlobalScope' in that specification.	Living Standard	No change from Web Workers.
Web Workers The definition of 'DedicatedWorkerGlobalScope' in that specification.	Editor's Draft	Initial definition.

Browser compatibility

[1] Gecko 29.0 implemented this as WorkerConsole. Gecko 30.0 changed this to the regular Console.

See also

• Worker
• WorkerGlobalScope
• Using web workers
• Functions available to workers