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.

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.

DedicatedWorkerGlobalScope.onmessage

Is an event handler 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 event handler 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.

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

atob()

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

btoa

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

clearInterval

Cancels the repeated execution set using setInterval.

clearTimeout

Cancels the repeated execution set using setTimeout.

setInterval

Schedules the execution of a function every X milliseconds.

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

Specification
HTML Standard (HTML)
# dedicated-workers-and-the-dedicatedworkerglobalscope-interface

Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
DedicatedWorkerGlobalScope
4
12
3.5
10
10.6
4
≤37
18
4
11
5
1.0
cancelAnimationFrame
69
79
No
No
56
No
67
69
No
48
No
10.0
close
4
12
3.5
10
10.6
4
≤37
18
4
11
5
1.0
message_event
4
12
3.5
10
10.6
4
≤37
Yes
4
11.5
5
Yes
messageerror_event
60
18
57
No
47
No
60
60
57
47
No
8.0
name
71
18
55
No
58
12.1
71
71
55
50
12.2
10.0
onmessage
4
12
3.5
10
10.6
4
≤37
Yes
4
11
5
Yes
onmessageerror
60
18
57
No
47
No
60
60
57
44
No
8.0
postMessage
4
12
3.5
10
10.6
4
≤37
Yes
4
11
5
Yes
requestAnimationFrame
69
79
No
No
56
No
67
69
No
48
No
10.0

See also

© 2005–2021 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/DedicatedWorkerGlobalScope