Cette page a été traduite à partir de l'anglais par la communauté.Vous pouvez contribuer en rejoignant la communauté francophone sur MDN Web Docs.
DedicatedWorkerGlobalScope
Baseline Widely available *
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
* Certaines parties de cette fonctionnalité peuvent bénéficier de prise en charge variables.
L'objetDedicatedWorkerGlobalScope (le contexte global duWorker) est accessible au moyen du mot cléself. Certaines fonctions globales additionnelles, des espaces de nom d'objets, et des constructeurs, non associés typiquement au contexte global d'un worker, et néanmoins disponibles, sont listés dans laRéférence JavaScript. Consultez aussi :Fonctions et classes disponibles dans les Web Workers.
Dans cet article
Propriétés
Cette interface hérite des propriétés de l'interfaceWorkerGlobalScope, et de son parentEventTarget, et implémente ainsi les propriétés deWindowTimers,WindowBase64, etWindowEventHandlers.
DedicatedWorkerGlobalScope.nameLecture seuleLe nom du
Workeroptionnellement donné lors de la création du worker avec le constructeurWorker(). Il est souvent utilisé pour du débogage.
Propriétés héritées de WorkerGlobalScope
WorkerGlobalScope.selfRetourne une référence d'objet à l'objet
DedicatedWorkerGlobalScopelui-même.WorkerGlobalScope.consoleLecture seuleRetourne la
Consoleassociée au worker.WorkerGlobalScope.locationLecture seuleRetourne la
WorkerLocationassociée au worker.WorkerLocationest un objet location spécifique, essentiellement un sous-ensemble deLocationutilisé dans le contexte d'un navigateur, mais adapté aux workers.WorkerGlobalScope.navigatorLecture seuleRetourne le
WorkerNavigatorassocié au worker.WorkerNavigatorest un objet navigator spécifique, essentiellement un sous-ensemble deNavigatorutilisé dans le contexte d'un navigateur, mais adapté aux workers.WorkerGlobalScope.performanceLecture seuleNon standardRetourne l'objet
Performanceassocié au worker, qui correspond à l'objet performance normal, avec seulement à disposition un sous-ensemble de ses propriétés et méthodes.
Gestionnaires d'événement
Cette interface hérite des gestionnaires d'événement de l'interfaceWorkerGlobalScope, et de son parentEventTarget, et implémente ainsi les gestionnaires d'événement deWindowTimers,WindowBase64, etWindowEventHandlers.
DedicatedWorkerGlobalScope.onmessageC'est un gestionnaire d'évènement représentant le code à appeler lorsqu'un événement [
message]/fr/docs/Web/API/DedicatedWorkerGlobalScope/message_event) est déclenché. Ces événements sont du typeMessageEventet sont appelés quand le worker reçoit un message du document qui l'a initialisé (i.e. à partir de la méthodeWorker.postMessage.)DedicatedWorkerGlobalScope.onmessageerrorC'est un gestionnaire d'évènement représentant le code à appeler lorsqu'un événement
messageerrorest déclenché.
Méthodes
Cette interface hérite des méthodes de l'interfaceWorkerGlobalScope, et de son parentEventTarget, et implémente ainsi les méthodes deWindowTimers,WindowBase64, etWindowEventHandlers.
WorkerGlobalScope.close()Annule toute tâche en attente dans la boucle d'événement du
WorkerGlobalScope, mettant alors fin à ce contexte précis.DedicatedWorkerGlobalScope.postMessageEnvoie un message — qui peut comprendre
n'importe quelobjet JavaScript — au document parent qui a préalablement engendré le worker.
Héritées de WorkerGlobalScope
WorkerGlobalScope.dump()Non standardÉcrit un message dans la console.
WorkerGlobalScope.importScripts()Importe un ou plusieurs scripts dans le contexte du worker. Vous pouvez spécifier autant de fichiers que souhaité, en les séparant par des virgules. Par exemple:
importScripts('foo.js', 'bar.js');
Implémentées à partir d'autres endroits
WindowBase64.atob()Décode une chaîne de données qui a été encodée en base-64.
WindowBase64.btoa()Crée une chaîne ASCII en base-64 à partir d'une chaîne de données binaires.
WindowTimers.clearInterval()Annule l'exécution répétée initiée par
WindowTimers.setInterval().WindowTimers.clearTimeout()Annule l'exécution répété initiée par
WindowTimers.setTimeout().WindowTimers.setInterval()Planifie l'exécution d'une fonction toutes les X millisecondes.
WindowTimers.setTimeout()Fixe un délai pour l'exécution d'une fonction.
Spécifications
| Specification |
|---|
| HTML> # dedicated-workers-and-the-dedicatedworkerglobalscope-interface> |