DedicatedWorkerGlobalScope

{{APIRef("Web Workers API")}} {{AvailableInWorkers("dedicated")}} 

The DedicatedWorkerGlobalScope object (the {{domxref("Worker")}}  global scope) is accessible through the {{domxref("WorkerGlobalScope.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.

{{InheritanceDiagram}} 

Instance properties

This interface inherits properties from the {{domxref("WorkerGlobalScope")}}  interface, and its parent {{domxref("EventTarget")}} .

• {{domxref("DedicatedWorkerGlobalScope.name")}}  {{ReadOnlyInline}} 
  • : The name that the {{domxref("Worker")}}  was (optionally) given when it was created using the {{domxref("Worker.Worker", "Worker()")}}  constructor. This is mainly useful for debugging purposes.

Instance methods

This interface inherits methods from the {{domxref("WorkerGlobalScope")}}  interface, and its parent {{domxref("EventTarget")}} .

• {{domxref("DedicatedWorkerGlobalScope.close()")}} 
  • : Discards any tasks queued in the WorkerGlobalScope’s event loop, effectively closing this particular scope.
• {{domxref("DedicatedWorkerGlobalScope.postMessage()")}} 
  • : Sends a message — which can consist of any JavaScript object — to the parent document that first spawned the worker.
• {{domxref("DedicatedWorkerGlobalScope.cancelAnimationFrame()")}} 
  • : Cancels an animation frame request previously scheduled through a call to {{domxref("DedicatedWorkerGlobalScope.requestAnimationFrame()", "requestAnimationFrame()")}} .
• {{domxref("DedicatedWorkerGlobalScope.requestAnimationFrame()")}} 
  • : Perform an animation frame request and call a user-supplied callback function before the next repaint.

Events

Listen to this event using {{domxref("EventTarget/addEventListener()", "addEventListener()")}}  or by assigning an event listener to the oneventname property of this interface.

• {{domxref("DedicatedWorkerGlobalScope/message_event", "message")}} 
  • : Fired when the worker receives a message from its parent.
• {{domxref("DedicatedWorkerGlobalScope/messageerror_event", "messageerror")}} 
  • : Fired when a worker receives a message that can’t be deserialized.
• {{domxref("DedicatedWorkerGlobalScope/rtctransform_event", "rtctransform")}} 
  • : Fired when an encoded video or audio frame has been queued for processing by a {{domxref("WebRTC API/Using Encoded Transforms", "WebRTC Encoded Transform", "", "nocode")}} .

Specifications

{{Specifications}} 

Browser compatibility

{{Compat}} 

See also

• {{domxref("Worker")}} 
• {{domxref("WorkerGlobalScope")}} 
• Using web workers
• Functions available to workers