{{APIRef("Web Workers API")}}
The DedicatedWorkerGlobalScope
object (the {{domxref("Worker")}} global scope) is accessible through the {{domxref("window.self","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 {{domxref("WorkerGlobalScope")}} interface, and its parent {{domxref("EventTarget")}}, and therefore implements properties from {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, and {{domxref("WindowEventHandlers")}}.
Properties inherited from WorkerGlobalScope
- {{domxref("WorkerGlobalScope.self")}}
- Returns an object reference to the
DedicatedWorkerGlobalScope
object itself. - {{domxref("WorkerGlobalScope.console")}} {{readOnlyinline}}
- Returns the {{domxref("Console")}} associated with the worker.
- {{domxref("WorkerGlobalScope.location")}} {{readOnlyinline}}
- Returns the {{domxref("WorkerLocation")}} associated with the worker.
WorkerLocation
is a specific location object, mostly a subset of the {{domxref("Location")}} for browsing scopes, but adapted to workers. - {{domxref("WorkerGlobalScope.navigator")}} {{readOnlyinline}}
- Returns the {{domxref("WorkerNavigator")}} associated with the worker.
WorkerNavigator
is a specific navigator object, mostly a subset of the {{domxref("Navigator")}} for browsing scopes, but adapted to workers. - {{domxref("WorkerGlobalScope.performance")}} {{readOnlyinline}} {{Non-standard_inline}}
- Returns the {{domxref("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 {{domxref("WorkerGlobalScope")}} interface, and its parent {{domxref("EventTarget")}}, and therefore implements event handlers from {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, and {{domxref("WindowEventHandlers")}}.
- {{domxref("DedicatedWorkerGlobalScope.onmessage")}}
- Is an {{domxref("EventHandler")}} representing the code to be called when the {{event("message")}} event is raised. These events are of type {{domxref("MessageEvent")}} and will be called when the worker receives a message from the document that started it (i.e. from the {{domxref("Worker.postMessage")}} method.)
Methods
This interface inherits methods from the {{domxref("WorkerGlobalScope")}} interface, and its parent {{domxref("EventTarget")}}, and therefore implements methods from {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, and {{domxref("WindowEventHandlers")}}.
- {{domxref("DedicatedWorkerGlobalScope.postMessage")}}
- Sends a message — which can consist of
any
JavaScript object — to the parent document that first spawned the worker.
Inherited from WorkerGlobalScope
- {{domxref("WorkerGlobalScope.close()")}}
- Discards any tasks queued in the
WorkerGlobalScope
's event loop, effectively closing this particular scope. - {{domxref("WorkerGlobalScope.dump()")}} {{non-standard_inline}}
- Writes a message to the console.
- {{domxref("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
- {{domxref("WindowBase64.atob()")}}
- Decodes a string of data which has been encoded using base-64 encoding.
- {{domxref("WindowBase64.btoa()")}}
- Creates a base-64 encoded ASCII string from a string of binary data.
- {{domxref("WindowTimers.clearInterval()")}}
- Cancels the repeated execution set using {{domxref("WindowTimers.setInterval()")}}.
- {{domxref("WindowTimers.clearTimeout()")}}
- Cancels the repeated execution set using {{domxref("WindowTimers.setTimeout()")}}.
- {{domxref("WindowTimers.setInterval()")}}
- Schedules the execution of a function every X milliseconds.
- {{domxref("WindowTimers.setTimeout()")}}
- Sets a delay for executing a function.
Specifications
Specification | Status | Comment |
---|---|---|
{{SpecName('HTML WHATWG', '#dedicatedworkerglobalscope', 'DedicatedWorkerGlobalScope')}} | {{Spec2('HTML WHATWG')}} | No change from {{SpecName("Web Workers")}}. |
{{SpecName('Web Workers', '#dedicatedworkerglobalscope', 'DedicatedWorkerGlobalScope')}} | {{Spec2('Web Workers')}} | Initial definition. |
Browser compatibility
{{ CompatibilityTable() }}
Feature | Chrome | Firefox (Gecko) | Internet Explorer | Opera | Safari |
---|---|---|---|---|---|
Basic support | {{CompatChrome(4)}} | {{CompatGeckoDesktop("1.9.1")}} | 10 | 10.6 | 4 |
ononline , onoffline |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("29")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
console {{Non-standard_inline}} |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("29")}} as WorkerConsole {{CompatGeckoDesktop("30")}} as the regular Console |
{{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
performance |
{{CompatVersionUnknown}} | {{CompatGeckoDesktop("34")}} | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
Feature | Android | Chrome for Android | Firefox Mobile (Gecko) | Firefox OS (Gecko) | IE Mobile | Opera Mobile | Safari Mobile |
---|---|---|---|---|---|---|---|
Basic support | {{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("1.9.1")}} | 1.0.1 | 10 | 11.5 | 5.1 |
ononline , onoffline |
{{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("29")}} as a specific WorkerConsole {{CompatGeckoMobile("30")}} as the regular Console |
1.4 | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
console {{Non-standard_inline}} |
{{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("29")}} | 1.4 | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
performance |
{{CompatUnknown}} | {{CompatVersionUnknown}} | {{CompatGeckoMobile("34")}} | 2.1 | {{CompatUnknown}} | {{CompatUnknown}} | {{CompatUnknown}} |
See also
- {{domxref("Worker")}}
- {{domxref("WorkerGlobalScope")}}
- Using web workers
- Functions available to workers