Join MDN and developers like you at Mozilla's View Source conference, 12-14 September in Berlin, Germany. Learn more at https://viewsourceconf.org

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

Feature Chrome Firefox (Gecko) Internet Explorer Opera Safari
Basic support 4 3.5 (1.9.1) 10 10.6 4
ononline, onoffline (Yes) 29 (29) ? ? ?
console (Yes) 29 (29)[1]
30 (30)
? ? ?
performance (Yes) 34 (34) ? ? ?
Feature Android Chrome for Android Firefox Mobile (Gecko) Firefox OS (Gecko) IE Mobile Opera Mobile Safari Mobile
Basic support ? (Yes) 1.0 (1.9.1) 1.0.1 10 11.5 5.1
ononline, onoffline ? (Yes) 29.0 (29)[1]
30.0 (30)
1.4 ? ? ?
console ? (Yes) 29.0 (29) 1.4 ? ? ?
performance ? (Yes) 34.0 (34) 2.1 ? ? ?

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

See also

Document Tags and Contributors

 Contributors to this page: Sebastianz, teoli, chrisdavidmills, ethertank, Sheppy, fusionchess
 Last updated by: Sebastianz,