diff options
Diffstat (limited to 'files/fr/web/api/workerglobalscope/index.md')
| -rw-r--r-- | files/fr/web/api/workerglobalscope/index.md | 231 |
1 files changed, 101 insertions, 130 deletions
diff --git a/files/fr/web/api/workerglobalscope/index.md b/files/fr/web/api/workerglobalscope/index.md index 946df930aa..1f37730fe7 100644 --- a/files/fr/web/api/workerglobalscope/index.md +++ b/files/fr/web/api/workerglobalscope/index.md @@ -10,136 +10,107 @@ tags: - Workers translation_of: Web/API/WorkerGlobalScope --- -<p>{{APIRef("Web Workers API")}}</p> +{{APIRef("Web Workers API")}} -<p>L'interface <code><strong>WorkerGlobalScope</strong></code> de l'<a href="/en-US/docs/Web/API/Web_Workers_API">API Web Workers</a> est une interface représentant la portée de tout worker. Les Workers n'ont pas de contexte de navigation; cette portée contient les informations généralement véhiculées par les objets {{domxref("Window")}} — dans ce cas les gestionnaires d'événements, la console ou l'objet {{domxref("WorkerNavigator")}} associé. Chaque <code>WorkerGlobalScope</code> a sa propre boucle d'événements.</p> +L'interface **`WorkerGlobalScope`** de l'[API Web Workers](/en-US/docs/Web/API/Web_Workers_API) est une interface représentant la portée de tout worker. Les Workers n'ont pas de contexte de navigation; cette portée contient les informations généralement véhiculées par les objets {{domxref("Window")}} — dans ce cas les gestionnaires d'événements, la console ou l'objet {{domxref("WorkerNavigator")}} associé. Chaque `WorkerGlobalScope` a sa propre boucle d'événements. -<p>Cette interface est généralement spécialisée par chaque type de worker : {{domxref("DedicatedWorkerGlobalScope")}} pour les workers dédiés, {{domxref("SharedWorkerGlobalScope")}} pour les workers partagés, et {{domxref("ServiceWorkerGlobalScope")}} pour <a href="/en-US/docs/Web/API/ServiceWorker_API">ServiceWorker</a>. La propriété <code>self</code> renvoie la portée spécialisée pour chaque contexte.</p> +Cette interface est généralement spécialisée par chaque type de worker : {{domxref("DedicatedWorkerGlobalScope")}} pour les workers dédiés, {{domxref("SharedWorkerGlobalScope")}} pour les workers partagés, et {{domxref("ServiceWorkerGlobalScope")}} pour [ServiceWorker](/en-US/docs/Web/API/ServiceWorker_API). La propriété `self` renvoie la portée spécialisée pour chaque contexte. -<h2 id="Propriétés">Propriétés</h2> - -<p><em>Cette interface hérite des propriétés de l'interface {{domxref("EventTarget")}} et implémente les propriétés de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}.</em></p> - -<h3 id="Propriétés_standard">Propriétés standard</h3> - -<dl> - <dt>{{domxref("WorkerGlobalScope.navigator")}} {{readOnlyinline}}</dt> - <dd>Renvoie le {{domxref("WorkerNavigator")}} associé au worker. C'est un objet navigator spécifique, principalement un sous-ensemble de {{domxref("Navigator")}} pour la navigation dans les portées, mais adapté aux workers.</dd> - <dt>{{domxref("WorkerGlobalScope.self")}} {{readOnlyinline}}</dt> - <dd>Renvoie une référence au <code>WorkerGlobalScope</code> lui-même. La plupart du temps, il s'agit d'une portée spécifique comme {{domxref("DedicatedWorkerGlobalScope")}}, {{domxref("SharedWorkerGlobalScope")}} ou {{domxref("ServiceWorkerGlobalScope")}}.</dd> - <dt>{{domxref("WorkerGlobalScope.location")}} {{readOnlyinline}}</dt> - <dd>Renvoie le {{domxref("WorkerLocation")}} associé au worker. Il s'agit d'un objet de localisation spécifique, principalement un sous-ensemble de {{domxref ("Location")}} pour les portées de navigation, mais adapté aux workers.</dd> -</dl> - -<h3 id="Propriétés_non_standard">Propriétés non standard</h3> - -<dl> - <dt>{{domxref("WorkerGlobalScope.performance")}} {{readOnlyinline}} {{Non-standard_inline}}</dt> - <dd>Renvoie la {{domxref ("Performance")}} associée au worker. Il s'agit d'un objet de performance standard, sauf que seul un sous-ensemble de sa propriété et de ses méthodes est disponible pour les nœuds de calcul.</dd> - <dt>{{domxref("WorkerGlobalScope.console")}} {{readOnlyinline}} {{Non-standard_inline}}</dt> - <dd>Renvoie la {{domxref("Console")}} associée au worker.</dd> -</dl> - -<h3 id="Gestionnaires_dévénements">Gestionnaires d'événements</h3> - -<p>Cette interface hérite des gestionnaires d'événements de l'interface {{domxref ("EventTarget")}} et implémente les gestionnaires d'événements de {{domxref ("WindowTimers")}} et {{domxref ("WindowBase64")}}.</p> - -<dl> - <dt>{{domxref("WorkerGlobalScope.onerror")}}</dt> - <dd>Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("error")}} est déclenché.</dd> - <dt>{{domxref("WorkerGlobalScope.onoffline")}}</dt> - <dd>Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("offline")}} est déclenché.</dd> - <dt>{{domxref("WorkerGlobalScope.ononline")}}</dt> - <dd>Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("online")}} est déclenché.</dd> - <dt>{{domxref("WorkerGlobalScope.onlanguagechange")}}</dt> - <dd>Un {{domxref ("EventHandler")}} déclenché sur l'objet de portée global / worker lorsque les langues préférées de l'utilisateur changent.</dd> -</dl> - -<dl> - <dt>{{domxref("WorkerGlobalScope.onclose")}} {{Non-standard_inline}}</dt> - <dd>Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("close")}} est déclenché.</dd> -</dl> - -<h2 id="Méthodes">Méthodes</h2> - -<p>Cette interface hérite des méthodes de l'interface {{domxref ("EventTarget")}} et implémente les méthodes de {{domxref ("WindowTimers")}}, {{domxref ("WindowBase64")}}, {{domxref ("WindowEventHandlers")}} et {{domxref ("GlobalFetch")}}.</p> - -<h3 id="Méthodes_standard">Méthodes standard</h3> - -<dl> - <dt>{{domxref("WorkerGlobalScope.close()")}}</dt> - <dd>Ignore toutes les tâches mises en file d'attente dans la boucle d'événements de <code>WorkerGlobalScope</code>, fermant ainsi cette portée particulière.</dd> - <dt>{{domxref("WorkerGlobalScope.importScripts()")}}</dt> - <dd>Importe un ou plusieurs scripts dans la portée du worker. Vous pouvez en spécifier autant que vous le souhaitez, séparés par des virgules. Par exemple:<code> importScripts('foo.js', 'bar.js');</code></dd> -</dl> - -<h3 id="Méthodes_non_standard">Méthodes non standard</h3> - -<dl> - <dt>{{domxref("WorkerGlobalScope.dump()")}} {{non-standard_inline}}</dt> - <dd>Vous permet d'écrire un message stdout — c'est-à-dire dans votre terminal. C'est la même chose que {{domxref ("window.dump")}} de Firefox, mais pour les workers.</dd> -</dl> - -<h3 id="Méthodes_mises_en_œuvre_dailleurs">Méthodes mises en œuvre d'ailleurs</h3> - -<dl> - <dt>{{domxref("WindowBase64.atob()")}}</dt> - <dd>Décode une chaîne de données qui a été encodée à l'aide d'un encodage base 64.</dd> - <dt>{{domxref("WindowBase64.btoa()")}}</dt> - <dd>Crée une chaîne ASCII encodée 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 définie à l'aide de {{domxref ("WindowTimers.setInterval ()")}}.</dd> - <dt>{{domxref("WindowTimers.clearTimeout()")}}</dt> - <dd>Annule l'exécution répétée définie à l'aide de {{domxref ("WindowTimers.setTimeout ()")}}.</dd> - <dt>{{domxref("GlobalFetch.fetch()")}}</dt> - <dd>Démarre le processus de récupération d'une ressource.</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>Définit un délai pour l'exécution d'une fonction.</dd> -</dl> - -<h2 id="Exemple">Exemple</h2> - -<p>Vous n'accéderez pas à <code>WorkerGlobalScope</code> directement dans votre code; cependant, ses propriétés et méthodes sont héritées par des portées globales plus spécifiques telles que {{domxref ("DedicatedWorkerGlobalScope")}} et {{domxref ("SharedWorkerGlobalScope")}}. Par exemple, vous pouvez importer un autre script dans le worker et imprimer le contenu de l'objet <code>navigator</code> de l'étendue du worker en utilisant les deux lignes suivantes:</p> - -<pre class="brush: js">importScripts('foo.js'); -console.log(navigator);</pre> - -<div class="note"> -<p><strong>Note :</strong> Étant donné que la portée globale du script de worker est effectivement la portée globale du worker que vous exécutez ({{domxref ("DedicatedWorkerGlobalScope")}} ou autre) et que toutes les portées globales de worker héritent des méthodes, des propriétés, etc. À partir de <code>WorkerGlobalScope</code>, vous pouvez exécuter des lignes telles que celles ci-dessus sans spécifier d'objet parent.</p> -</div> - -<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', '#workerglobalscope', 'WorkerGlobalScope')}}</td> - <td>{{Spec2('HTML WHATWG')}}</td> - <td>Aucun changement par rapport à {{SpecName ("Web Workers")}}.</td> - </tr> - <tr> - <td>{{SpecName('Web Workers', '#workerglobalscope', 'WorkerGlobalScope')}}</td> - <td>{{Spec2('Web Workers')}}</td> - <td>Définition initiale.</td> - </tr> - </tbody> -</table> - -<h2 id="Browser_compatibility">Compatibilité des navigateurs</h2> - -<p>{{Compat("api.WorkerGlobalScope")}}</p> - -<h2 id="See_also">Voir aussi</h2> - -<ul> - <li>Autre interface d'objet globale: {{domxref("Window")}}, {{domxref("DedicatedWorkerGlobalScope")}}, {{domxref("SharedWorkerGlobalScope")}}, , {{domxref("ServiceWorkerGlobalScope")}}</li> - <li>Autres interfaces liées aux travailleurs: {{domxref("Worker")}}, {{domxref("WorkerLocation")}}, {{domxref("WorkerGlobalScope")}}, et {{domxref("ServiceWorkerGlobalScope")}}.</li> - <li><a href="/fr/docs/Web/Guide/Performance/Using_web_workers">Utilisation de web workers.</a></li> -</ul> +## Propriétés + +_Cette interface hérite des propriétés de l'interface {{domxref("EventTarget")}} et implémente les propriétés de {{domxref("WindowTimers")}}, {{domxref("WindowBase64")}}, et {{domxref("WindowEventHandlers")}}._ + +### Propriétés standard + +- {{domxref("WorkerGlobalScope.navigator")}} {{readOnlyinline}} + - : Renvoie le {{domxref("WorkerNavigator")}} associé au worker. C'est un objet navigator spécifique, principalement un sous-ensemble de {{domxref("Navigator")}} pour la navigation dans les portées, mais adapté aux workers. +- {{domxref("WorkerGlobalScope.self")}} {{readOnlyinline}} + - : Renvoie une référence au `WorkerGlobalScope` lui-même. La plupart du temps, il s'agit d'une portée spécifique comme {{domxref("DedicatedWorkerGlobalScope")}}, {{domxref("SharedWorkerGlobalScope")}} ou {{domxref("ServiceWorkerGlobalScope")}}. +- {{domxref("WorkerGlobalScope.location")}} {{readOnlyinline}} + - : Renvoie le {{domxref("WorkerLocation")}} associé au worker. Il s'agit d'un objet de localisation spécifique, principalement un sous-ensemble de {{domxref ("Location")}} pour les portées de navigation, mais adapté aux workers. + +### Propriétés non standard + +- {{domxref("WorkerGlobalScope.performance")}} {{readOnlyinline}} {{Non-standard_inline}} + - : Renvoie la {{domxref ("Performance")}} associée au worker. Il s'agit d'un objet de performance standard, sauf que seul un sous-ensemble de sa propriété et de ses méthodes est disponible pour les nœuds de calcul. +- {{domxref("WorkerGlobalScope.console")}} {{readOnlyinline}} {{Non-standard_inline}} + - : Renvoie la {{domxref("Console")}} associée au worker. + +### Gestionnaires d'événements + +Cette interface hérite des gestionnaires d'événements de l'interface {{domxref ("EventTarget")}} et implémente les gestionnaires d'événements de {{domxref ("WindowTimers")}} et {{domxref ("WindowBase64")}}. + +- {{domxref("WorkerGlobalScope.onerror")}} + - : Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("error")}} est déclenché. +- {{domxref("WorkerGlobalScope.onoffline")}} + - : Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("offline")}} est déclenché. +- {{domxref("WorkerGlobalScope.ononline")}} + - : Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("online")}} est déclenché. +- {{domxref("WorkerGlobalScope.onlanguagechange")}} + - : Un {{domxref ("EventHandler")}} déclenché sur l'objet de portée global / worker lorsque les langues préférées de l'utilisateur changent. + +<!----> + +- {{domxref("WorkerGlobalScope.onclose")}} {{Non-standard_inline}} + - : Est un {{domxref ("EventHandler")}} représentant le code à appeler lorsque l'événement {{event ("close")}} est déclenché. + +## Méthodes + +Cette interface hérite des méthodes de l'interface {{domxref ("EventTarget")}} et implémente les méthodes de {{domxref ("WindowTimers")}}, {{domxref ("WindowBase64")}}, {{domxref ("WindowEventHandlers")}} et {{domxref ("GlobalFetch")}}. + +### Méthodes standard + +- {{domxref("WorkerGlobalScope.close()")}} + - : Ignore toutes les tâches mises en file d'attente dans la boucle d'événements de `WorkerGlobalScope`, fermant ainsi cette portée particulière. +- {{domxref("WorkerGlobalScope.importScripts()")}} + - : Importe un ou plusieurs scripts dans la portée du worker. Vous pouvez en spécifier autant que vous le souhaitez, séparés par des virgules. Par exemple:` importScripts('foo.js', 'bar.js');` + +### Méthodes non standard + +- {{domxref("WorkerGlobalScope.dump()")}} {{non-standard_inline}} + - : Vous permet d'écrire un message stdout — c'est-à-dire dans votre terminal. C'est la même chose que {{domxref ("window.dump")}} de Firefox, mais pour les workers. + +### Méthodes mises en œuvre d'ailleurs + +- {{domxref("WindowBase64.atob()")}} + - : Décode une chaîne de données qui a été encodée à l'aide d'un encodage base 64. +- {{domxref("WindowBase64.btoa()")}} + - : Crée une chaîne ASCII encodée en base 64 à partir d'une chaîne de données binaires. +- {{domxref("WindowTimers.clearInterval()")}} + - : Annule l'exécution répétée définie à l'aide de {{domxref ("WindowTimers.setInterval ()")}}. +- {{domxref("WindowTimers.clearTimeout()")}} + - : Annule l'exécution répétée définie à l'aide de {{domxref ("WindowTimers.setTimeout ()")}}. +- {{domxref("GlobalFetch.fetch()")}} + - : Démarre le processus de récupération d'une ressource. +- {{domxref("WindowTimers.setInterval()")}} + - : Planifie l'exécution d'une fonction toutes les X millisecondes. +- {{domxref("WindowTimers.setTimeout()")}} + - : Définit un délai pour l'exécution d'une fonction. + +## Exemple + +Vous n'accéderez pas à `WorkerGlobalScope` directement dans votre code; cependant, ses propriétés et méthodes sont héritées par des portées globales plus spécifiques telles que {{domxref ("DedicatedWorkerGlobalScope")}} et {{domxref ("SharedWorkerGlobalScope")}}. Par exemple, vous pouvez importer un autre script dans le worker et imprimer le contenu de l'objet `navigator` de l'étendue du worker en utilisant les deux lignes suivantes: + +```js +importScripts('foo.js'); +console.log(navigator); +``` + +> **Note :** Étant donné que la portée globale du script de worker est effectivement la portée globale du worker que vous exécutez ({{domxref ("DedicatedWorkerGlobalScope")}} ou autre) et que toutes les portées globales de worker héritent des méthodes, des propriétés, etc. À partir de `WorkerGlobalScope`, vous pouvez exécuter des lignes telles que celles ci-dessus sans spécifier d'objet parent. + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------------------- | -------------------------------- | -------------------------------------------------------------------- | +| {{SpecName('HTML WHATWG', '#workerglobalscope', 'WorkerGlobalScope')}} | {{Spec2('HTML WHATWG')}} | Aucun changement par rapport à {{SpecName ("Web Workers")}}. | +| {{SpecName('Web Workers', '#workerglobalscope', 'WorkerGlobalScope')}} | {{Spec2('Web Workers')}} | Définition initiale. | + +## Compatibilité des navigateurs + +{{Compat("api.WorkerGlobalScope")}} + +## Voir aussi + +- Autre interface d'objet globale: {{domxref("Window")}}, {{domxref("DedicatedWorkerGlobalScope")}}, {{domxref("SharedWorkerGlobalScope")}}, , {{domxref("ServiceWorkerGlobalScope")}} +- Autres interfaces liées aux travailleurs: {{domxref("Worker")}}, {{domxref("WorkerLocation")}}, {{domxref("WorkerGlobalScope")}}, et {{domxref("ServiceWorkerGlobalScope")}}. +- [Utilisation de web workers.](/fr/docs/Web/Guide/Performance/Using_web_workers) |