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.

DedicatedWorkerGlobalScope.name Read only

The name that the Worker was (optionally) given when it was created using the Worker() constructor. This is mainly useful for debugging purposes.

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.)

DedicatedWorkerGlobalScope.onmessageerror

Is an EventHandler representing the code to be called when the messageerror event is raised.

Methods

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

DedicatedWorkerGlobalScope.close()

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

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.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.

Events

message

Fired when the worker receives a message from its parent.
Also available via the onmessage property.

messageerror

Fired when a worker receives a message that can't be deserialized.
Also available via the onmessageerror property.

Specifications

Browser compatibility

See also

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