ContextQMD
Back to Content

DedicatedWorkerGlobalScope

files/en-us/web/api/dedicatedworkerglobalscope/index.md

latest3.0 KB
Original Source

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