diff options
Diffstat (limited to 'files/fr/web/api/dedicatedworkerglobalscope/index.md')
| -rw-r--r-- | files/fr/web/api/dedicatedworkerglobalscope/index.md | 189 |
1 files changed, 80 insertions, 109 deletions
diff --git a/files/fr/web/api/dedicatedworkerglobalscope/index.md b/files/fr/web/api/dedicatedworkerglobalscope/index.md index 20417cc38e..6f8edf15bd 100644 --- a/files/fr/web/api/dedicatedworkerglobalscope/index.md +++ b/files/fr/web/api/dedicatedworkerglobalscope/index.md @@ -3,112 +3,83 @@ title: DedicatedWorkerGlobalScope slug: Web/API/DedicatedWorkerGlobalScope translation_of: Web/API/DedicatedWorkerGlobalScope --- -<p>{{APIRef("Web Workers API")}}</p> - -<p>L'objet <strong><code>DedicatedWorkerGlobalScope</code></strong> (le contexte global du {{domxref("Worker")}}) est accessible au moyen du mot clé {{domxref("window.self","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 la <a href="/fr/docs/Web/JavaScript/Reference">Référence JavaScript</a>. Consultez aussi : <a href="/fr/docs/Web/Guide/Needs_categorization/Functions_available_to_workers">Fonctions et classes disponibles dans les Web Workers</a>.</p> - -<h2 id="Propriétés">Propriétés</h2> - -<p><em>Cette interface hérite des propriétés de l'interface {{domxref("WorkerGlobalScope")}}, et de son parent {{domxref("EventTarget")}}, et implémente ainsi les propriétés de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}.</em></p> - -<dl> - <dt>{{domxref("DedicatedWorkerGlobalScope.name")}} {{readOnlyinline}}</dt> - <dd>Le nom du {{domxref("Worker")}} optionnellement donné lors de la création du worker avec le constructeur {{domxref("Worker.Worker", "Worker()")}}. Il est souvent utilisé pour du débogage.</dd> -</dl> - -<h3 id="Propriétés_héritées_de_WorkerGlobalScope">Propriétés héritées de WorkerGlobalScope</h3> - -<dl> - <dt>{{domxref("WorkerGlobalScope.self")}}</dt> - <dd>Retourne une référence d'objet à l'objet <code>DedicatedWorkerGlobalScope</code> lui-même.</dd> - <dt>{{domxref("WorkerGlobalScope.console")}} {{readOnlyinline}}</dt> - <dd>Retourne la {{domxref("Console")}} associée au worker.</dd> - <dt>{{domxref("WorkerGlobalScope.location")}} {{readOnlyinline}}</dt> - <dd>Retourne la {{domxref("WorkerLocation")}} associée au worker. <code>WorkerLocation</code> est un objet location spécifique, essentiellement un sous-ensemble de {{domxref("Location")}} utilisé dans le contexte d'un navigateur, mais adapté aux workers.</dd> - <dt>{{domxref("WorkerGlobalScope.navigator")}} {{readOnlyinline}}</dt> - <dd>Retourne le {{domxref("WorkerNavigator")}} associé au worker. <code>WorkerNavigator</code> est un objet navigator spécifique, essentiellement un sous-ensemble de {{domxref("Navigator")}} utilisé dans le contexte d'un navigateur, mais adapté aux workers.</dd> - <dt>{{domxref("WorkerGlobalScope.performance")}} {{readOnlyinline}} {{Non-standard_inline}}</dt> - <dd>Retourne l'objet {{domxref("Performance")}} associé au worker, qui correspond à l'objet performance normal, avec seulement à disposition un sous-ensemble de ses propriétés et méthodes.</dd> -</dl> - -<h3 id="Gestionnaires_dévénement">Gestionnaires d'événement</h3> - -<p><em>Cette interface hérite des gestionnaires d'événement de l'interface {{domxref("WorkerGlobalScope")}}, et de son parent {{domxref("EventTarget")}}, et implémente ainsi les gestionnaires d'événement de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}.</em></p> - -<dl> - <dt>{{domxref("DedicatedWorkerGlobalScope.onmessage")}}</dt> - <dd>C'est un {{event("Event_handlers", "event handler")}} représentant le code à appeler lorsqu'un événement {{event("message")}} est déclenché. Ces événements sont du type {{domxref("MessageEvent")}} et sont appelés quand le worker reçoit un message du document qui l'a initialisé (i.e. à partir de la méthode {{domxref("Worker.postMessage")}}.)</dd> - <dt>{{domxref("DedicatedWorkerGlobalScope.onmessageerror")}}</dt> - <dd>C'est un {{event("Event_handlers", "event handler")}} représentant le code à appeler lorsqu'un événement {{event("messageerror")}} est déclenché.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<p><em>Cette interface hérite des méthodes de l'interface {{domxref("WorkerGlobalScope")}}, et de son parent {{domxref("EventTarget")}}, et implémente ainsi les méthodes de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}.</em></p> - -<dl> - <dt>{{domxref("WorkerGlobalScope.close()")}}</dt> - <dd>Annule toute tâche en attente dans la boucle d'événement du <code>WorkerGlobalScope</code>, mettant alors fin à ce contexte précis.</dd> - <dt>{{domxref("DedicatedWorkerGlobalScope.postMessage")}}</dt> - <dd>Envoie un message — qui peut comprendre <code>n'importe quel</code> objet JavaScript — au document parent qui a préalablement engendré le worker.</dd> -</dl> - -<h3 id="Héritées_de_WorkerGlobalScope">Héritées de WorkerGlobalScope</h3> - -<dl> - <dt>{{domxref("WorkerGlobalScope.dump()")}} {{non-standard_inline}}</dt> - <dd>Écrit un message dans la console.</dd> - <dt>{{domxref("WorkerGlobalScope.importScripts()")}}</dt> - <dd>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: <code>importScripts('foo.js', 'bar.js');</code></dd> -</dl> - -<h3 id="Implémentées_à_partir_dautres_endroits">Implémentées à partir d'autres endroits</h3> - -<dl> - <dt>{{domxref("WindowBase64.atob()")}}</dt> - <dd>Décode une chaîne de données qui a été encodée en base-64.</dd> - <dt>{{domxref("WindowBase64.btoa()")}}</dt> - <dd>Crée une chaîne ASCII en base-64 à partir d'une chaîne de données binaires.</dd> - <dt>{{domxref("WindowTimers.clearInterval()")}}</dt> - <dd>Annule l'exécution répétée initiée par {{domxref("WindowTimers.setInterval()")}}.</dd> - <dt>{{domxref("WindowTimers.clearTimeout()")}}</dt> - <dd>Annule l'exécution répété initiée par {{domxref("WindowTimers.setTimeout()")}}.</dd> - <dt>{{domxref("WindowTimers.setInterval()")}}</dt> - <dd>Planifie l'exécution d'une fonction toutes les X millisecondes.</dd> - <dt>{{domxref("WindowTimers.setTimeout()")}}</dt> - <dd>Fixe un délai pour l'exécution d'une fonction.</dd> -</dl> - -<h2 id="Spécifications">Spécifications</h2> - -<table class="standard-table"> - <tbody> - <tr> - <th scope="col">Spécification</th> - <th scope="col">Statut</th> - <th scope="col">Commentaire</th> - </tr> - <tr> - <td>{{SpecName('HTML WHATWG', '#dedicatedworkerglobalscope', 'DedicatedWorkerGlobalScope')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td></td> - </tr> - </tbody> -</table> - -<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> - -<div> - - -<p>{{Compat("api.DedicatedWorkerGlobalScope")}}</p> -</div> - -<h2 id="Voir_aussi">Voir aussi</h2> - -<ul> - <li>{{domxref("Worker")}}</li> - <li>{{domxref("WorkerGlobalScope")}}</li> - <li><a href="/fr/docs/Web/Guide/Performance/Using_web_workers">Utilisation des web workers</a></li> - <li><a href="/fr/docs/Web/Guide/Needs_categorization/Functions_available_to_workers">Fonctions et classes disponibles dans les Web Workers</a></li> -</ul> +{{APIRef("Web Workers API")}} + +L'objet **`DedicatedWorkerGlobalScope`** (le contexte global du {{domxref("Worker")}}) est accessible au moyen du mot clé {{domxref("window.self","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 la [Référence JavaScript](/fr/docs/Web/JavaScript/Reference). Consultez aussi : [Fonctions et classes disponibles dans les Web Workers](/fr/docs/Web/Guide/Needs_categorization/Functions_available_to_workers). + +## Propriétés + +_Cette interface hérite des propriétés de l'interface {{domxref("WorkerGlobalScope")}}, et de son parent {{domxref("EventTarget")}}, et implémente ainsi les propriétés de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}._ + +- {{domxref("DedicatedWorkerGlobalScope.name")}} {{readOnlyinline}} + - : Le nom du {{domxref("Worker")}} optionnellement donné lors de la création du worker avec le constructeur {{domxref("Worker.Worker", "Worker()")}}. Il est souvent utilisé pour du débogage. + +### Propriétés héritées de WorkerGlobalScope + +- {{domxref("WorkerGlobalScope.self")}} + - : Retourne une référence d'objet à l'objet `DedicatedWorkerGlobalScope` lui-même. +- {{domxref("WorkerGlobalScope.console")}} {{readOnlyinline}} + - : Retourne la {{domxref("Console")}} associée au worker. +- {{domxref("WorkerGlobalScope.location")}} {{readOnlyinline}} + - : Retourne la {{domxref("WorkerLocation")}} associée au worker. `WorkerLocation` est un objet location spécifique, essentiellement un sous-ensemble de {{domxref("Location")}} utilisé dans le contexte d'un navigateur, mais adapté aux workers. +- {{domxref("WorkerGlobalScope.navigator")}} {{readOnlyinline}} + - : Retourne le {{domxref("WorkerNavigator")}} associé au worker. `WorkerNavigator` est un objet navigator spécifique, essentiellement un sous-ensemble de {{domxref("Navigator")}} utilisé dans le contexte d'un navigateur, mais adapté aux workers. +- {{domxref("WorkerGlobalScope.performance")}} {{readOnlyinline}} {{Non-standard_inline}} + - : Retourne l'objet {{domxref("Performance")}} associé 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'interface {{domxref("WorkerGlobalScope")}}, et de son parent {{domxref("EventTarget")}}, et implémente ainsi les gestionnaires d'événement de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}._ + +- {{domxref("DedicatedWorkerGlobalScope.onmessage")}} + - : C'est un {{event("Event_handlers", "event handler")}} représentant le code à appeler lorsqu'un événement {{event("message")}} est déclenché. Ces événements sont du type {{domxref("MessageEvent")}} et sont appelés quand le worker reçoit un message du document qui l'a initialisé (i.e. à partir de la méthode {{domxref("Worker.postMessage")}}.) +- {{domxref("DedicatedWorkerGlobalScope.onmessageerror")}} + - : C'est un {{event("Event_handlers", "event handler")}} représentant le code à appeler lorsqu'un événement {{event("messageerror")}} est déclenché. + +## Méthodes + +_Cette interface hérite des méthodes de l'interface {{domxref("WorkerGlobalScope")}}, et de son parent {{domxref("EventTarget")}}, et implémente ainsi les méthodes de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}._ + +- {{domxref("WorkerGlobalScope.close()")}} + - : Annule toute tâche en attente dans la boucle d'événement du `WorkerGlobalScope`, mettant alors fin à ce contexte précis. +- {{domxref("DedicatedWorkerGlobalScope.postMessage")}} + - : Envoie un message — qui peut comprendre `n'importe quel` objet JavaScript — au document parent qui a préalablement engendré le worker. + +### Héritées de WorkerGlobalScope + +- {{domxref("WorkerGlobalScope.dump()")}} {{non-standard_inline}} + - : Écrit un message dans la console. +- {{domxref("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 + +- {{domxref("WindowBase64.atob()")}} + - : Décode une chaîne de données qui a été encodée en base-64. +- {{domxref("WindowBase64.btoa()")}} + - : Crée une chaîne ASCII en base-64 à partir d'une chaîne de données binaires. +- {{domxref("WindowTimers.clearInterval()")}} + - : Annule l'exécution répétée initiée par {{domxref("WindowTimers.setInterval()")}}. +- {{domxref("WindowTimers.clearTimeout()")}} + - : Annule l'exécution répété initiée par {{domxref("WindowTimers.setTimeout()")}}. +- {{domxref("WindowTimers.setInterval()")}} + - : Planifie l'exécution d'une fonction toutes les X millisecondes. +- {{domxref("WindowTimers.setTimeout()")}} + - : Fixe un délai pour l'exécution d'une fonction. + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('HTML WHATWG', '#dedicatedworkerglobalscope', 'DedicatedWorkerGlobalScope')}} | {{Spec2('HTML WHATWG')}} | | + +## Compatibilité des navigateurs + +{{Compat("api.DedicatedWorkerGlobalScope")}} + +## Voir aussi + +- {{domxref("Worker")}} +- {{domxref("WorkerGlobalScope")}} +- [Utilisation des web workers](/fr/docs/Web/Guide/Performance/Using_web_workers) +- [Fonctions et classes disponibles dans les Web Workers](/fr/docs/Web/Guide/Needs_categorization/Functions_available_to_workers) |