diff options
Diffstat (limited to 'files/fr/web/api/workerglobalscope/index.md')
| -rw-r--r-- | files/fr/web/api/workerglobalscope/index.md | 145 |
1 files changed, 145 insertions, 0 deletions
diff --git a/files/fr/web/api/workerglobalscope/index.md b/files/fr/web/api/workerglobalscope/index.md new file mode 100644 index 0000000000..946df930aa --- /dev/null +++ b/files/fr/web/api/workerglobalscope/index.md @@ -0,0 +1,145 @@ +--- +title: WorkerGlobalScope +slug: Web/API/WorkerGlobalScope +tags: + - API + - Interface + - Reference + - TopicStub + - WorkerGlobalScope + - Workers +translation_of: Web/API/WorkerGlobalScope +--- +<p>{{APIRef("Web Workers API")}}</p> + +<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> + +<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> + +<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> |