diff options
author | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
---|---|---|
committer | Peter Bengtsson <mail@peterbe.com> | 2020-12-08 14:40:17 -0500 |
commit | 33058f2b292b3a581333bdfb21b8f671898c5060 (patch) | |
tree | 51c3e392513ec574331b2d3f85c394445ea803c6 /files/fr/web/api/workerglobalscope | |
parent | 8b66d724f7caf0157093fb09cfec8fbd0c6ad50a (diff) | |
download | translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.gz translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.tar.bz2 translated-content-33058f2b292b3a581333bdfb21b8f671898c5060.zip |
initial commit
Diffstat (limited to 'files/fr/web/api/workerglobalscope')
13 files changed, 913 insertions, 0 deletions
diff --git a/files/fr/web/api/workerglobalscope/close/index.html b/files/fr/web/api/workerglobalscope/close/index.html new file mode 100644 index 0000000000..4d02224a9d --- /dev/null +++ b/files/fr/web/api/workerglobalscope/close/index.html @@ -0,0 +1,34 @@ +--- +title: WorkerGlobalScope.close() +slug: Web/API/WorkerGlobalScope/close +translation_of: Web/API/WorkerGlobalScope/close +--- +<p>{{APIRef("Web Workers API")}}{{obsolete_header}}</p> + +<p>La méthode <code><strong>close()</strong></code> de l'interface {{domxref("WorkerGlobalScope")}} annule toutes les tâches en attente dans la boucle d'événements du <code>WorkerGlobalScope</code>, mettant fin alors à ce contexte précis.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">self.close();</pre> + +<h2 id="Exemple">Exemple</h2> + +<p>Si vous souhaitez fermer votre instance de worker au sein du worker lui-même, vous pouvez appeler la méthode comme suit :</p> + +<pre class="brush: js">close();</pre> + +<p><code>close()</code> et <code>self.close()</code> sont effectivement équivalentes — les deux expressions correspondent à un appel de la méthode <code>close()</code> à partir du contexte local du worker.</p> + +<div class="note"> +<p><strong>Remarque</strong>: il y a également une façon de stopper le worker à partir du thread principal: la méthode {{domxref("Worker.terminate")}}.</p> +</div> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.close")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>{{domxref("WorkerGlobalScope")}}</p> diff --git a/files/fr/web/api/workerglobalscope/console/index.html b/files/fr/web/api/workerglobalscope/console/index.html new file mode 100644 index 0000000000..f045e26b62 --- /dev/null +++ b/files/fr/web/api/workerglobalscope/console/index.html @@ -0,0 +1,50 @@ +--- +title: WorkerGlobalScope.console +slug: Web/API/WorkerGlobalScope/console +tags: + - API + - Propriété + - Reference + - Web Workers + - WorkerGlobalScope + - lecture seule +translation_of: Web/API/WorkerGlobalScope/console +--- +<p>{{APIRef("Web Workers API")}}{{Non-standard_header}}</p> + +<p>La propriété en lecture seule <code><strong>console</strong></code> de l'interface {{domxref("WorkerGlobalScope")}} retourne un objet {{domxref("Console")}} donnant accès à la console du navigateur pour le worker.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">var consoleObj = self.console;</pre> + +<h3 id="Valeur">Valeur</h3> + +<p>Un objet {{domxref("Console")}}.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Cette propriété vous permet d'avoir accès à la console du navigateur à des fins de débogage dans un worker. Par exemple, vous pouvez appeler</p> + +<pre class="brush: js">console.log('test');</pre> + +<p>dans un worker (qui est tout simplement l'équivalent de <code>self.console.log('test');</code>, car appelé dans le contexte du worker, qui peut être référencé par {{domxref("WorkerGlobalScope.self")}}), afin de retourner un message de test dans la console du navigateur.</p> + +<p>Si vous appelez <code>console.log()</code> depuis un {{domxref("DedicatedWorkerGlobalScope")}} ou un autre contexte qui agit sur une seule fenêtre chargée, la console de l'onglet correspondant recevra le message. En revanche, si vous appelez <code>console.log()</code> depuis un {{domxref("SharedWorkerGlobalScope")}}, la console globale du navigateur recevra le message.</p> + +<h2 id="Specifications" name="Specifications">Spécifications</h2> + +<p>Ne fait pas encore parti d'une spécification.</p> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.console")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<ul> + <li>{{domxref("Console")}}</li> + <li>{{domxref("WorkerGlobalScope")}}</li> +</ul> diff --git a/files/fr/web/api/workerglobalscope/dump/index.html b/files/fr/web/api/workerglobalscope/dump/index.html new file mode 100644 index 0000000000..8a6d9e31f2 --- /dev/null +++ b/files/fr/web/api/workerglobalscope/dump/index.html @@ -0,0 +1,52 @@ +--- +title: WorkerGlobalScope.dump() +slug: Web/API/WorkerGlobalScope/dump +translation_of: Web/API/WorkerGlobalScope/dump +--- +<div>{{APIRef("Web Workers API")}}</div> + +<div class="blockIndicator warning"> +<p><span class="pl-s1"><span class="pl-s">Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web : elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</span></span></p> +</div> + +<p>La méthode <code><strong>dump()</strong></code> de l'interface {{domxref("WorkerGlobalScope")}} permet d'écrire des messages vers <code>stdout</code> — i.e. dans le terminal, seulement sur Firefox. C'est la même chose que {{domxref("window.dump")}} dans Firefox, mais pour les <em>worker</em>s.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">dump('Mon message\n');</pre> + +<h3 id="Paramètre">Paramètre</h3> + +<p>Une {{domxref("DOMString")}} contenant le message que vous voulez envoyer.</p> + +<h3 id="Retour">Retour</h3> + +<p>Rien.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Pour écrire quelque chose depuis votre <em>worker</em> vers votre terminal, vous devez d'abord ouvrir une instance de Firefox depuis votre invité de commande ou terminal. Par exemple, sous Mac OS X vous le lancer en utilisant quelque chose comme (en supposant que vous êtes dans le répertoire de l'application):</p> + +<pre class="brush: bash">./Firefox.app/Contents/MacOS/firefox-bin -profile /tmp -no-remote</pre> + +<p>Maintenant allez dans <code>about:config</code> et activez la préférence <code>browser.dom.window.dump.enabled</code>.</p> + +<p>Après, lancez un worker contenant la ligne suivante:</p> + +<pre class="brush: js">dump('test\n');</pre> + +<p>Vous devriez observer le message «test» apparaître dans le terminal.</p> + +<h2 id="Spécifications">Spécifications</h2> + +<p>Cette méthode n’apparaît dans aucune spécification.</p> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.dump")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>{{domxref("WorkerGlobalScope")}}</p> diff --git a/files/fr/web/api/workerglobalscope/importscripts/index.html b/files/fr/web/api/workerglobalscope/importscripts/index.html new file mode 100644 index 0000000000..1ec7ac124b --- /dev/null +++ b/files/fr/web/api/workerglobalscope/importscripts/index.html @@ -0,0 +1,73 @@ +--- +title: WorkerGlobalScope.importScripts() +slug: Web/API/WorkerGlobalScope/importScripts +translation_of: Web/API/WorkerGlobalScope/importScripts +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La méthode <code><strong>importScripts()</strong></code> de l'interface synchrome {{domxref("WorkerGlobalScope")}} importe un ou plusieurs scripts dans l'environnement du worker.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">self.importScripts('foo.js'); +self.importScripts('foo.js', 'bar.js', ...);</pre> + +<h3 id="Specifications" name="Specifications">Paramètres</h3> + +<p>Une liste d'objets {{domxref("DOMString")}} séparés par des virgules et représentant les scripts à importer.</p> + +<h3 id="Valeur_de_retour">Valeur de retour</h3> + +<p>Rien.</p> + +<h3 id="Exceptions">Exceptions</h3> + +<table class="standard-table"> + <thead> + <tr> + <th scope="col">Exception</th> + <th scope="col">Description</th> + </tr> + </thead> + <tbody> + <tr> + <td><code>NetworkError</code></td> + <td>Importer un script qui n'est pas servi avec un type MIME valide. (i.e. <code>text/javascript</code>).</td> + </tr> + </tbody> +</table> + +<h2 id="Exemple">Exemple</h2> + +<p>Si vous disposez d'un code présent dans un script indépendant appelé <code>foo.js</code> que vous souhaitez utiliser à l'intérieur de worker.js, vous pouvez l'importer de la façon suivante:</p> + +<pre class="brush: js">importScripts('foo.js');</pre> + +<p><code>importScripts()</code> et <code>self.importScripts()</code> sont effectivement équivalentes — les deux expressions correspondent à la façon d'appeler <code>importScripts()</code> au sein du contexte local du worker.</p> + +<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', '#dom-workerglobalscope-importscripts', 'importScripts()')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden">he compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</div> + +<p>{{Compat("api.WorkerGlobalScope.importScripts")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>{{domxref("WorkerGlobalScope")}}</p> diff --git a/files/fr/web/api/workerglobalscope/index.html b/files/fr/web/api/workerglobalscope/index.html new file mode 100644 index 0000000000..56d0b2210c --- /dev/null +++ b/files/fr/web/api/workerglobalscope/index.html @@ -0,0 +1,254 @@ +--- +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 notranslate">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="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<p>{{ CompatibilityTable() }}</p> + +<div id="compat-desktop"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Chrome</th> + <th>Firefox (Gecko)</th> + <th>Internet Explorer</th> + <th>Opera</th> + <th>Safari</th> + </tr> + <tr> + <td>Support de base</td> + <td>{{CompatChrome(4)}}</td> + <td>{{CompatGeckoDesktop("1.9.1")}}</td> + <td>10</td> + <td>10.6</td> + <td>4</td> + </tr> + <tr> + <td><code>ononline</code>, <code>onoffline</code></td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("29")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>console</code> {{Non-standard_inline}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("29")}} as <code>WorkerConsole</code><br> + {{CompatGeckoDesktop("30")}} as the regular <code>Console</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>performance</code></td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoDesktop("34")}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<div id="compat-mobile"> +<table class="compat-table"> + <tbody> + <tr> + <th>Fonctionnalité</th> + <th>Android</th> + <th>Chrome for Android</th> + <th>Firefox Mobile (Gecko)</th> + <th>Firefox OS (Gecko)</th> + <th>IE Mobile</th> + <th>Opera Mobile</th> + <th>Safari Mobile</th> + </tr> + <tr> + <td>Support de base</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("1.9.1")}}</td> + <td>1.0.1</td> + <td>10</td> + <td>11.5</td> + <td>5.1</td> + </tr> + <tr> + <td><code>ononline</code>, <code>onoffline</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("29")}} as a specific <code>WorkerConsole</code><br> + {{CompatGeckoMobile("30")}} as the regular <code>Console</code></td> + <td>1.4</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>console</code> {{Non-standard_inline}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("29")}}</td> + <td>1.4</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + <tr> + <td><code>performance</code></td> + <td>{{CompatUnknown}}</td> + <td>{{CompatVersionUnknown}}</td> + <td>{{CompatGeckoMobile("34")}}</td> + <td>2.1</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + <td>{{CompatUnknown}}</td> + </tr> + </tbody> +</table> +</div> + +<h2 id="Voir_également">Voir également</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="/en-US/docs/Web/Guide/Performance/Using_web_workers" title="/en-US/docs/Web/Guide/Performance/Using_web_workers">Utilisation de web workers.</a></li> +</ul> + +<dl> +</dl> diff --git a/files/fr/web/api/workerglobalscope/location/index.html b/files/fr/web/api/workerglobalscope/location/index.html new file mode 100644 index 0000000000..9406fa3aeb --- /dev/null +++ b/files/fr/web/api/workerglobalscope/location/index.html @@ -0,0 +1,69 @@ +--- +title: WorkerGlobalScope.location +slug: Web/API/WorkerGlobalScope/location +translation_of: Web/API/WorkerGlobalScope/location +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La propriété en lecture seule <code><strong>location</strong></code> de l'interface {{domxref("WorkerGlobalScope")}} retourne l'objet {{domxref("WorkerLocation")}} associé au worker. C'est un objet location spécifique, essentiellement un sous-ensemble de {{domxref("Location")}} pour les contextes de navigation, mais adapté aux workers.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">var locationObj = self.location;</pre> + +<h3 id="Specifications" name="Specifications">Valeur de retour</h3> + +<p>Un objet {{domxref("WorkerLocation")}}.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Si vous appelez l'instruction suivante dans un document délivré par <code>localhost:8000</code></p> + +<pre class="brush: js">console.log(location);</pre> + +<p>à l'intérieur d'un worker (ce qui équivaut à <code>self.console.log(self.location);</code>, puisqu'il est appelé dans le contexte du worker qui peut être référencé par {{domxref("WorkerGlobalScope.self")}}), la console vous retournera un objet {{domxref("WorkerLocation")}} — comme ce qui suit :</p> + +<pre class="brush: js">WorkerLocation {hash: "", search: "", pathname: "/worker.js", port: "8000", hostname: "localhost"…} + hash: "" + host: "localhost:8000" + hostname: "localhost" + href: "http://localhost:8000/worker.js" + origin: "http://localhost:8000" + pathname: "/worker.js" + port: "8000" + protocol: "http:" + search: "" + __proto__: WorkerLocation</pre> + +<p>Vous pouvez utiliser l'objet location pour récupérer des informations supplémentaires sur la localisation du document, comme vous pourriez le faire avec un objet {{domxref("Location")}} normal.</p> + +<div class="note"> +<p><strong>Remarque </strong>: Firefox rencontre un bogue avec l'utilisation de <code>console.log</code> à l'intérieur des workers partagés/service (voir {{Bug("1058644")}}), ce qui peut occasionner d'étranges résultats, mais cela devrait être bientôt corrigé.</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', '#dom-workerglobalscope-location', 'location')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.location")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>{{domxref("WorkerGlobalScope")}}</p> diff --git a/files/fr/web/api/workerglobalscope/navigator/index.html b/files/fr/web/api/workerglobalscope/navigator/index.html new file mode 100644 index 0000000000..a90b3657fc --- /dev/null +++ b/files/fr/web/api/workerglobalscope/navigator/index.html @@ -0,0 +1,70 @@ +--- +title: WorkerGlobalScope.navigator +slug: Web/API/WorkerGlobalScope/navigator +translation_of: Web/API/WorkerGlobalScope/navigator +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La propriété en lecture seule <code><strong>navigator</strong></code> de l'interface {{domxref("WorkerGlobalScope")}} retourne le {{domxref("WorkerNavigator")}} associé au worker. C'est un objet navigator spécifique, essentiellement un sous-ensemble de {{domxref("Navigator")}} pour les contextes de navigation, mais adapté aux workers.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">var navigatorObj = self.navigator;</pre> + +<h3 id="Specifications" name="Specifications">Valeur de retour</h3> + +<p>Un objet {{domxref("WorkerNavigator")}}.</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Si vous appelez</p> + +<pre class="brush: js">console.log(navigator);</pre> + +<p>à l'intérieur d'un worker (ce qui équivaut à <code>self.console.log(self.navigator);</code>, puisqu'il est appelé dans le contexte du worker qui peut être référencé par {{domxref("WorkerGlobalScope.self")}}), la console vous retournera un objet {{domxref("WorkerNavigator")}} — comme ce qui suit :</p> + +<pre class="brush: js">Object {onLine: true, userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) Ap…ML, like Gecko) Chrome/40.0.2214.93 Safari/537.36", product: "Gecko", platform: "MacIntel", appVersion: "5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKi…ML, like Gecko) Chrome/40.0.2214.93 Safari/537.36"…} + appCodeName: "Mozilla" + appName: "Netscape" + appVersion: "5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.93 Safari/537.36" + hardwareConcurrency: 4 + onLine: true + platform: "MacIntel" + product: "Gecko" + userAgent: "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_10_1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/40.0.2214.93 Safari/537.36" + __proto__: Object</pre> + +<p>Vous pouvez utiliser l'objet navigator pour récupérer des informations supplémentaires sur l'environnement d'exécution, comme vous pourriez le faire avec un objet {{domxref("Navigator")}} normal.</p> + +<div class="note"> +<p><strong>Remarque </strong>: Firefox rencontre un bogue avec l'utilisation de <code>console.log</code> à l'intérieur des workers partagés/service (voir {{Bug("1058644")}}), ce qui peut occasionner d'étranges résultats, mais cela devrait être bientôt corrigé.</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', '#dom-worker-navigator', 'navigator')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden"> +<p>The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> +</div> + +<p>{{Compat("api.WorkerGlobalScope.navigator")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>{{domxref("WorkerNavigator")}}</p> diff --git a/files/fr/web/api/workerglobalscope/onclose/index.html b/files/fr/web/api/workerglobalscope/onclose/index.html new file mode 100644 index 0000000000..1eee58ed77 --- /dev/null +++ b/files/fr/web/api/workerglobalscope/onclose/index.html @@ -0,0 +1,42 @@ +--- +title: WorkerGlobalScope.onclose +slug: Web/API/WorkerGlobalScope/onclose +translation_of: Web/API/WorkerGlobalScope/onclose +--- +<p>{{APIRef("Web Workers API")}}{{obsolete_header}}</p> + +<div class="blockIndicator warning"> +<p><strong>Non-standard</strong></p> + +<p>Cette fonctionnalité n'est ni standard, ni en voie de standardisation. Ne l'utilisez pas pour des sites accessibles sur le Web: elle ne fonctionnera pas pour tout utilisateur. Il peut également y avoir d'importantes incompatibilités entre les implémentations et son comportement peut être modifié dans le futur.</p> +</div> + +<h2 id="Résumé">Résumé</h2> + +<p>La propriété <strong><code>onclose</code></strong> de l'interface {{domxref("WorkerGlobalScope")}} représente un {{domxref("EventHandler")}} à appeler lorsque l'événement {{event("close")}} survient et se propage à travers le {{domxref("Worker")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre>self.onclose = function() { ... };</pre> + +<h2 id="Exemple">Exemple</h2> + +<p>L'extrait de code suivant montre la création d'un gestionnaire <code>onclose</code> placé au sein d'un worker :</p> + +<pre class="brush: js">self.onclose = function() { + console.log('Your worker instance has been closed'); +}</pre> + +<h2 id="Spécifications">Spécifications</h2> + +<p>Cette fonctionnalité n'est défini dans plus aucune spécification.</p> + +<h2 id="Compatibilité_des_naviguateurs">Compatibilité des naviguateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.onclose")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>L'interface {{domxref("WorkerGlobalScope")}} à laquelle elle appartient.</p> diff --git a/files/fr/web/api/workerglobalscope/onerror/index.html b/files/fr/web/api/workerglobalscope/onerror/index.html new file mode 100644 index 0000000000..f2c782a986 --- /dev/null +++ b/files/fr/web/api/workerglobalscope/onerror/index.html @@ -0,0 +1,47 @@ +--- +title: WorkerGlobalScope.onerror +slug: Web/API/WorkerGlobalScope/onerror +translation_of: Web/API/WorkerGlobalScope/onerror +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La propriété <strong><code>onerror</code></strong> de l'interface {{domxref("WorkerGlobalScope")}} représente un {{domxref("EventHandler")}} à appeler lorsque l'événement {{event("error")}} survient et se propage à travers le {{domxref("Worker")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre>self.onerror = function() { ... };</pre> + +<h2 id="Exemple">Exemple</h2> + +<p>L'extrait de code suivant montre un gestionnaire <code>onerror</code> placé au sein d'un worker :</p> + +<pre class="brush: js">self.onerror = function() { + console.log('There is an error inside your worker!'); +}</pre> + +<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', "#handler-workerglobalscope-onerror", "WorkerGlobalScope.onerror")}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_naviguateurs">Compatibilité des naviguateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.onerror")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>L'interface {{domxref("WorkerGlobalScope")}} à laquelle il appartient.</p> diff --git a/files/fr/web/api/workerglobalscope/onlanguagechange/index.html b/files/fr/web/api/workerglobalscope/onlanguagechange/index.html new file mode 100644 index 0000000000..674f00906a --- /dev/null +++ b/files/fr/web/api/workerglobalscope/onlanguagechange/index.html @@ -0,0 +1,47 @@ +--- +title: WorkerGlobalScope.onlanguagechange +slug: Web/API/WorkerGlobalScope/onlanguagechange +translation_of: Web/API/WorkerGlobalScope/onlanguagechange +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La propriété <strong><code>onlanguagechange</code></strong> de l'interface {{domxref("WorkerGlobalScope")}} représente un {{domxref("EventHandler")}} à appeler lorsque l'événement {{event("languagechange")}} survient et se propage à travers le {{domxref("Worker")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre>self.onlanguagechange = function() { ... };</pre> + +<h2 id="Exemple">Exemple</h2> + +<p>L'extrait de code suivant montre un gestionnaire <code>onlanguagechange</code> placé au sein d'un worker :</p> + +<pre class="brush: js">self.onlanguagechange = function() { + console.log('Your preferred language settings have been changed'); +}</pre> + +<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', "#handler-workerglobalscope-onlanguagechange", "WorkerGlobalScope.onlanguagechange")}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.onlanguagechange")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>L'interface {{domxref("WorkerGlobalScope")}} à laquelle elle appartient.</p> diff --git a/files/fr/web/api/workerglobalscope/onoffline/index.html b/files/fr/web/api/workerglobalscope/onoffline/index.html new file mode 100644 index 0000000000..df5d70eb36 --- /dev/null +++ b/files/fr/web/api/workerglobalscope/onoffline/index.html @@ -0,0 +1,47 @@ +--- +title: WorkerGlobalScope.onoffline +slug: Web/API/WorkerGlobalScope/onoffline +translation_of: Web/API/WorkerGlobalScope/onoffline +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La propriété <strong><code>onoffline</code></strong> de l'interface {{domxref("WorkerGlobalScope")}} représente un {{domxref("EventHandler")}} à appeler lorsque l'événement {{event("offline")}} survient et se propage à travers le {{domxref("Worker")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre>self.onoffline = function() { ... };</pre> + +<h2 id="Exemple">Exemple</h2> + +<p>L'extrait de code suivant montre un gestionnaire <code>onoffline</code> placé dans un worker :</p> + +<pre class="brush: js">self.onoffline = function() { + console.log('Your worker is now offline'); +}</pre> + +<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', "#handler-workerglobalscope-onoffline", "WorkerGlobalScope.onoffline")}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + + + +<p>{{Compat("api.WorkerGlobalScope.onoffline")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>L'interface {{domxref("WorkerGlobalScope")}} à laquelle il appartient.</p> diff --git a/files/fr/web/api/workerglobalscope/ononline/index.html b/files/fr/web/api/workerglobalscope/ononline/index.html new file mode 100644 index 0000000000..0b8d96433b --- /dev/null +++ b/files/fr/web/api/workerglobalscope/ononline/index.html @@ -0,0 +1,49 @@ +--- +title: WorkerGlobalScope.ononline +slug: Web/API/WorkerGlobalScope/ononline +translation_of: Web/API/WorkerGlobalScope/ononline +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La propriété <strong><code>ononline</code></strong> de l'interface {{domxref("WorkerGlobalScope")}} représente un {{domxref("EventHandler")}} à appeler lorsque l'événement {{event("online")}} survient et se propage à travers le {{domxref("Worker")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre>self.ononline = function() { ... };</pre> + +<h2 id="Exemple">Exemple</h2> + +<p>L'extrait de code suivant montre un gestionnaire <code>ononline</code> placé dans un worker :</p> + +<pre class="brush: js">self.ononline = function() { + console.log('Your worker is now online'); +}</pre> + +<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', "#handler-workerglobalscope-ononline", "WorkerGlobalScope.ononline")}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden"> +<p>The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> +</div> + +<p>{{Compat("api.WorkerGlobalScope.ononline")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>L'interface {{domxref("WorkerGlobalScope")}} à laquelle il appartient.</p> diff --git a/files/fr/web/api/workerglobalscope/self/index.html b/files/fr/web/api/workerglobalscope/self/index.html new file mode 100644 index 0000000000..ef79718e43 --- /dev/null +++ b/files/fr/web/api/workerglobalscope/self/index.html @@ -0,0 +1,79 @@ +--- +title: WorkerGlobalScope.self +slug: Web/API/WorkerGlobalScope/self +translation_of: Web/API/WorkerGlobalScope/self +--- +<p>{{APIRef("Web Workers API")}}</p> + +<p>La propriété en lecture seule <code><strong>self</strong></code> de l'interface {{domxref("WorkerGlobalScope")}} retourne une référence au <code>WorkerGlobalScope</code> lui-même. La plupart du temps il s'agit d'un contexte spécifique comme {{domxref("DedicatedWorkerGlobalScope")}}, {{domxref("SharedWorkerGlobalScope")}}, ou {{domxref("ServiceWorkerGlobalScope")}}.</p> + +<h2 id="Syntaxe">Syntaxe</h2> + +<pre class="brush: js">var selfRef = self;</pre> + +<h3 id="Specifications" name="Specifications">Valeur</h3> + +<p>Un objet global scope (qui diffère selon le type du worker concerné, comme indiqué ci-dessus).</p> + +<h2 id="Exemple">Exemple</h2> + +<p>Si vous appelez</p> + +<pre class="brush: js">console.log(self);</pre> + +<p>au sein d'un worker, vous obtiendrez un worker global scope du même type que l'objet worker écrit sur la console — quelque chose comme ce qui suit :</p> + +<pre class="brush: js">DedicatedWorkerGlobalScope { +undefined: undefined, Infinity: Infinity, Math: MathConstructor, NaN: NaN, Intl: Object…} + Infinity: Infinity + Array: function Array() { [native code] } + arguments: null + caller: null + isArray: function isArray() { [native code] } + length: 1 + name: "Array" + observe: function observe() { [native code] } + prototype: Array[0] + unobserve: function unobserve() { [native code] } + __proto__: function Empty() {} + <function scope> + ArrayBuffer: function ArrayBuffer() { [native code] } + Blob: function Blob() { [native code] } + Boolean: function Boolean() { [native code] } + DataView: function DataView() { [native code] } + Date: function Date() { [native code] } + DedicatedWorkerGlobalScope: function DedicatedWorkerGlobalScope() { [native code] } + Error: function Error() { [native code] } +<em>// etc. etc.</em> +</pre> + +<p>Cette trace fournit la liste complète des objets disponibles dans le contexte d'un worker, et constitue un test très utile lorsqu'il s'agit de savoir ce qui est disponible ou non au sein d'un worker. Nous maintenons aussi une liste des <a href="/en-US/docs/Web/API/Worker/Functions_and_classes_available_to_workers">Fonctions et classes disponibles dans les Web Workers</a>.</p> + +<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', '#dom-workerglobalscope-self', 'self')}}</td> + <td>{{Spec2('HTML WHATWG')}}</td> + <td></td> + </tr> + </tbody> +</table> + +<h2 id="Compatibilité_des_navigateurs">Compatibilité des navigateurs</h2> + +<div class="hidden"> +<p>The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out <a href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> and send us a pull request.</p> +</div> + +<p>{{Compat("api.WorkerGlobalScope.self")}}</p> + +<h2 id="Voir_aussi">Voir aussi</h2> + +<p>{{domxref("WorkerGlobalScope")}}</p> |