From 1407c8fdef01ecd0ffb8a8bd46e7113f119b9fde Mon Sep 17 00:00:00 2001 From: julieng Date: Sat, 2 Oct 2021 17:20:24 +0200 Subject: convert content to md --- files/fr/web/api/sharedworker/index.md | 112 +++++++++------------ files/fr/web/api/sharedworker/port/index.md | 57 ++++------- .../fr/web/api/sharedworker/sharedworker/index.md | 100 ++++++++---------- 3 files changed, 112 insertions(+), 157 deletions(-) (limited to 'files/fr/web/api/sharedworker') diff --git a/files/fr/web/api/sharedworker/index.md b/files/fr/web/api/sharedworker/index.md index 1e5e6b0351..dc36979082 100644 --- a/files/fr/web/api/sharedworker/index.md +++ b/files/fr/web/api/sharedworker/index.md @@ -10,54 +10,52 @@ tags: - Worker translation_of: Web/API/SharedWorker --- -
{{APIRef("Web Workers API")}}
+{{APIRef("Web Workers API")}} -

L'interface SharedWorker représente un type spécifique de worker qui peut être accédé à partir de plusieurs contextes de navigation, tels que plusieurs fenêtres, iframes ou même workers. Ils implémentent une autre interface que les workers dédiés et ont un contexte global différent, {{domxref("SharedWorkerGlobalScope")}}.

+L'interface **`SharedWorker`** représente un type spécifique de worker qui peut être _accédé_ à partir de plusieurs contextes de navigation, tels que plusieurs fenêtres, iframes ou même workers. Ils implémentent une autre interface que les workers dédiés et ont un contexte global différent, {{domxref("SharedWorkerGlobalScope")}}. -
-

Note : Si un SharedWorker peut être accédé à partir de plusieurs contextes de navigation, tous ces contextes de navigation doivent partager exactement la même origine (même protocole, hôte et port.)

-
+> **Note :** Si un SharedWorker peut être accédé à partir de plusieurs contextes de navigation, tous ces contextes de navigation doivent partager exactement la même origine (même protocole, hôte et port.) -

Constructeurs

+## Constructeurs -
-
{{domxref("SharedWorker.SharedWorker", "SharedWorker()")}}
-
Crée un web worker partagé qui exécute le script spécifié par l'URL.
-
+- {{domxref("SharedWorker.SharedWorker", "SharedWorker()")}} + - : Crée un web worker partagé qui exécute le script spécifié par l'URL. -

Propriétés

+## Propriétés -

Il hérite des propriétés de son parent, {{domxref("EventTarget")}}, et implémente les propriétés de {{domxref("AbstractWorker")}}.

+_Il hérite des propriétés de son parent, {{domxref("EventTarget")}}, et implémente les propriétés de {{domxref("AbstractWorker")}}._ -
-
{{domxref("AbstractWorker.onerror")}}
-
Est un {{ domxref("EventListener") }} qui est appelé à chaque fois qu'un {{domxref("ErrorEvent")}} de type error se propage à travers le worker.
-
{{domxref("SharedWorker.port")}} {{readonlyInline}}
-
Retourne un objet {{domxref("MessagePort")}} utilisé pour communiquer et contrôler le worker partagé.
-
+- {{domxref("AbstractWorker.onerror")}} + - : Est un {{ domxref("EventListener") }} qui est appelé à chaque fois qu'un {{domxref("ErrorEvent")}} de type `error` se propage à travers le worker. +- {{domxref("SharedWorker.port")}} {{readonlyInline}} + - : Retourne un objet {{domxref("MessagePort")}} utilisé pour communiquer et contrôler le worker partagé. -
-
+ -

Méthodes

+## Méthodes -

Hérite des méthodes de son parent, {{domxref("EventTarget")}}, et implémente les méthodes de {{domxref("AbstractWorker")}}.

+_Hérite des méthodes de son parent, {{domxref("EventTarget")}}, et implémente les méthodes de {{domxref("AbstractWorker")}}._ -

Exemple

+## Exemple -

Dans notre  Exemple basique d'un worker partagé (lancer le worker partagé), nous avons deux pages HTML, qui chacune utilise du code JavaScript pour réaliser un calcul simple. Les différents scripts utilisent le même worker pour effectuer ce calcul — ils peuvent tous les deux y accéder, même si leurs pages s'exécutent à l'intérieur de fenêtres différentes.

+Dans notre  [Exemple basique d'un worker partagé](https://github.com/mdn/simple-shared-worker) ([lancer le worker partagé](http://mdn.github.io/simple-shared-worker/)), nous avons deux pages HTML, qui chacune utilise du code JavaScript pour réaliser un calcul simple. Les différents scripts utilisent le même worker pour effectuer ce calcul — ils peuvent tous les deux y accéder, même si leurs pages s'exécutent à l'intérieur de fenêtres différentes. -

L'extrait de code suivant illustre la création d'un objet SharedWorker en utilisant le constructeur {{domxref("SharedWorker.SharedWorker", "SharedWorker()")}}. Les deux scripts contiennent ceci :

+L'extrait de code suivant illustre la création d'un objet `SharedWorker` en utilisant le constructeur {{domxref("SharedWorker.SharedWorker", "SharedWorker()")}}. Les deux scripts contiennent ceci : -
var myWorker = new SharedWorker("worker.js");
+```js +var myWorker = new SharedWorker("worker.js"); +``` -

Les deux scripts accèdent alors au worker à travers un objet {{domxref("MessagePort")}} créé en utilisant la propriété {{domxref("SharedWorker.port")}} — le port est démarré au moyen de sa méthode start() :

+Les deux scripts accèdent alors au worker à travers un objet {{domxref("MessagePort")}} créé en utilisant la propriété {{domxref("SharedWorker.port")}} — le port est démarré au moyen de sa méthode `start()` : -
myWorker.port.start();
+```js +myWorker.port.start(); +``` -

Lorsque le port est démarré, les deux scripts envoient des messages au worker et gèrent les messages qu'il renvoie en utilisant respectivement port.postMessage() et port.onmessage :

+Lorsque le port est démarré, les deux scripts envoient des messages au worker et gèrent les messages qu'il renvoie en utilisant respectivement `port.postMessage()` et `port.onmessage` : -
first.onchange = function() {
+```js
+first.onchange = function() {
     myWorker.port.postMessage([first.value,second.value]);
     console.log('Message envoyé au worker');
   }
@@ -70,11 +68,13 @@ translation_of: Web/API/SharedWorker
   myWorker.port.onmessage = function(e) {
     result1.textContent = e.data;
     console.log('Message reçu du worker');
-  }
+ } +``` -

Au sein du worker, nous utilisons le gestionnaire {{domxref("SharedWorkerGlobalScope.onconnect")}} pour se connecter au même port dont il a été question plus haut. Les ports associés au worker sont accessibles dans la propriété ports de l'événement {{event("connect")}} — nous utilisons alors la méthode {{domxref("MessagePort")}} start() pour démarrer le port, et le gestionnaire onmessage pour s'occuper des messages en provenance des threads principaux.

+Au sein du worker, nous utilisons le gestionnaire {{domxref("SharedWorkerGlobalScope.onconnect")}} pour se connecter au même port dont il a été question plus haut. Les ports associés au worker sont accessibles dans la propriété `ports` de l'événement {{event("connect")}} — nous utilisons alors la méthode {{domxref("MessagePort")}} `start()` pour démarrer le port, et le gestionnaire `onmessage` pour s'occuper des messages en provenance des threads principaux. -
onconnect = function(e) {
+```js
+onconnect = function(e) {
     var port = e.ports[0];
 
     port.onmessage = function(e) {
@@ -83,32 +83,20 @@ translation_of: Web/API/SharedWorker
     }
 
     port.start();
-}
- -

Spécifications

- - - - - - - - - - - - - - -
SpécificationStatutCommentaire
{{SpecName('HTML WHATWG', "#sharedworker", "SharedWorker")}}{{Spec2('HTML WHATWG')}}Aucune modification de {{SpecName("Web Workers")}}.
- -

Compatibilité des navigateurs

- -

{{Compat("api.SharedWorker")}}

- -

Voir aussi

- - +} +``` + +## Spécifications + +| Spécification | Statut | Commentaire | +| -------------------------------------------------------------------------------- | -------------------------------- | ------------------------------------------------------------ | +| {{SpecName('HTML WHATWG', "#sharedworker", "SharedWorker")}} | {{Spec2('HTML WHATWG')}} | Aucune modification de {{SpecName("Web Workers")}}. | + +## Compatibilité des navigateurs + +{{Compat("api.SharedWorker")}} + +## Voir aussi + +- {{ domxref("Worker") }} +- [Utilisation des web workers](/fr/docs/Utilisation_des_web_workers) diff --git a/files/fr/web/api/sharedworker/port/index.md b/files/fr/web/api/sharedworker/port/index.md index 22bd830ee7..8e25c1c7f8 100644 --- a/files/fr/web/api/sharedworker/port/index.md +++ b/files/fr/web/api/sharedworker/port/index.md @@ -3,53 +3,40 @@ title: SharedWorker.port slug: Web/API/SharedWorker/port translation_of: Web/API/SharedWorker/port --- -
{{APIRef("Web Workers API")}}
+{{APIRef("Web Workers API")}} -

La propriété port de l'interface {{domxref("SharedWorker")}} retourne un objet {{domxref("MessagePort")}} utilisé pour contrôler et communiquer avec le worker partagé.

+La propriété **`port`** de l'interface {{domxref("SharedWorker")}} retourne un objet {{domxref("MessagePort")}} utilisé pour contrôler et communiquer avec le _worker_ partagé. -

Syntaxe

+## Syntaxe -
myWorker.port;
+ myWorker.port; -

Valeur

+### Valeur -

Un objet {{domxref("MessagePort")}}.

+Un objet {{domxref("MessagePort")}}. -

Exemple

+## Exemple -

L'exemple de code suivant montre la création de l'objet SharedWorker en utilisant le constructeur {{domxref("SharedWorker.SharedWorker", "SharedWorker()")}}. Plusieurs scriptes peuvent accéder au worker avec l'objet {{domxref("MessagePort")}} accessible grâce à la propriété SharedWorker.port — le port est ouvert avec la méthode start().

+L'exemple de code suivant montre la création de l'objet `SharedWorker` en utilisant le constructeur {{domxref("SharedWorker.SharedWorker", "SharedWorker()")}}. Plusieurs scriptes peuvent accéder au _worker_ avec l'objet {{domxref("MessagePort")}} accessible grâce à la propriété `SharedWorker.port` — le port est ouvert avec la méthode `start()`. -
var myWorker = new SharedWorker('worker.js');
-myWorker.port.start();
+```js +var myWorker = new SharedWorker('worker.js'); +myWorker.port.start(); +``` -

Pour un exemple complet, voir (en) Exemple basique de worker partagé ((en) démonstration d'un worker partagé.)

+Pour un exemple complet, voir [(en) Exemple basique de _worker_ partagé](https://github.com/mdn/simple-shared-worker) ([(en) démonstration d'un _worker_ partagé](https://mdn.github.io/simple-shared-worker/).) -

Spécifications

+## Spécifications - - - - - - - - - - - - - -
SpécificationsStatusCommentaire
{{SpecName('HTML WHATWG', "#dom-sharedworker-port", "AbstractWorker.onerror")}}{{Spec2('HTML WHATWG')}}
+| Spécifications | Status | Commentaire | +| -------------------------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('HTML WHATWG', "#dom-sharedworker-port", "AbstractWorker.onerror")}} | {{Spec2('HTML WHATWG')}} | | -

Compatibilité des navigateurs

+## Compatibilité des navigateurs +{{Compat("api.SharedWorker.port")}} +## Voir aussi -

{{Compat("api.SharedWorker.port")}}

- -

Voir aussi

- - +- L'interface {{domxref("SharedWorker")}} auquel il appartient. +- [(en) Une autre démonstration de multiplication.](https://anlexn.github.io/shared-worker-mdn/) diff --git a/files/fr/web/api/sharedworker/sharedworker/index.md b/files/fr/web/api/sharedworker/sharedworker/index.md index c4c35fb16d..c6fb6deb85 100644 --- a/files/fr/web/api/sharedworker/sharedworker/index.md +++ b/files/fr/web/api/sharedworker/sharedworker/index.md @@ -3,53 +3,47 @@ title: SharedWorker() slug: Web/API/SharedWorker/SharedWorker translation_of: Web/API/SharedWorker/SharedWorker --- -
{{APIRef("Web Workers API")}}
+{{APIRef("Web Workers API")}} -

Le constructeur SharedWorker() crée un objet {{domxref("SharedWorker")}} qui exécute le script depuis l'URL indiquée. Le script doit respecter la politique de même origine.

+Le constructeur **`SharedWorker()`** crée un objet {{domxref("SharedWorker")}} qui exécute le script depuis l'URL indiquée. Le script doit respecter la [politique de même origine](/fr/docs/Web/Security/Same-origin_policy). -
-

Note : Il y a désaccord entre les fabricants de navigateur pour savoir si l'URI doit avoir la même origine ou non. Bien que Gecko 10.0 {{geckoRelease("10.0")}} et les version supérieurs acceptent des origines différentes, ce n'est pas le cas des autres navigateurs.

-
+> **Note :** Il y a désaccord entre les fabricants de navigateur pour savoir si l'URI doit avoir la même origine ou non. Bien que Gecko 10.0 {{geckoRelease("10.0")}} et les version supérieurs acceptent des origines différentes, ce n'est pas le cas des autres navigateurs. -

Syntaxe

+## Syntaxe -
var monWorker = new SharedWorker(uneURL, nom);
-var monWorker = new SharedWorker(uneURL, options);
+ var monWorker = new SharedWorker(uneURL, nom); + var monWorker = new SharedWorker(uneURL, options); -

Paramètre

+### Paramètre -
-
uneURL
-
Une {{domxref("DOMString")}} qui représente l'URL du scripte du worker qui sera exécuté. Il doit obéir à la politique de même origine.
-
nom {{optional_inline}}
-
Une {{domxref("DOMString")}} indiquant un nom pour le {{domxref("SharedWorkerGlobalScope")}} représentant la portée du worker. Souvent utilisé pour le débogage.
-
options {{optional_inline}}
-
Une objet contenant les propriétés qui peuvent être défini à la création. Les propriété possibles sont: -
    -
  • type: Une {{domxref("DOMString")}} spécifiant le type de worker à créer. Les valeurs possibles sont: classic ou module. Si non spécifié, la valeur par défaut est classic.
    • -
  • credentials: Une {{domxref("DOMString")}} spécifiant le type de crédit à utilisé pour le worker. La valeur peut être omit, same-origin ou include. Si non spécifié ou si le type est classic, la valeur par défaut sera omit (pas de crédit nécéssaire).
    • -
  • name: Une {{domxref("DOMString")}} spécifiant un identifiant pour le {{domxref("SharedWorkerGlobalScope")}} représentant la porté du worker, souvent utilisé pour déboguer.
    • -
-
-
+- _uneURL_ + - : Une {{domxref("DOMString")}} qui représente l'URL du scripte du _worker_ qui sera exécuté. Il doit obéir à la politique de même origine. +- nom {{optional_inline}} + - : Une {{domxref("DOMString")}} indiquant un nom pour le {{domxref("SharedWorkerGlobalScope")}} représentant la portée du _worker_. Souvent utilisé pour le débogage. +- _options_ {{optional_inline}} -

Valeur retournée

+ - : Une objet contenant les propriétés qui peuvent être défini à la création. Les propriété possibles sont: -

Le woker créé.

+ - `type`: Une {{domxref("DOMString")}} spécifiant le type de _worker_ à créer. Les valeurs possibles sont: `classic` ou `module`. Si non spécifié, la valeur par défaut est `classic`. + - `credentials`: Une {{domxref("DOMString")}} spécifiant le type de crédit à utilisé pour le _worker_. La valeur peut être _`omit`_, `same-origin` ou _`include`. Si non spécifié ou si le type est `classic`, la valeur par défaut sera `omit` (pas de crédit nécéssaire)._ + - _`name`: Une _{{domxref("DOMString")}} spécifiant un identifiant pour le {{domxref("SharedWorkerGlobalScope")}} représentant la porté du _worker_, souvent utilisé pour déboguer. -

Exceptions

+### Valeur retournée - +Le _woker_ créé. -

Exemple

+### Exceptions -

L'extrait de code suivant montre la création d'un objet {{domxref("SharedWorker")}} en utilisant le contructeur SharedWorker() et l'usage qui en est fait.

+- Une `SecurityError` est levé si le document n'est pas autorisé à lancer le _worker_. Par exemple si l'URL a une syntaxe invalide ou si la politique de même origine est violée. +- Une `NetworkError` est levé si le type MIME du script _worker_ n'est pas correct. Le type MIME doit toujours être `text/javascript`. +- Une `SyntaxError` est levée si _uneURL_ ne peut pas être analysée. -
var myWorker = new SharedWorker('worker.js');
+## Exemple
+
+L'extrait de code suivant montre la création d'un objet {{domxref("SharedWorker")}} en utilisant le contructeur `SharedWorker()` et l'usage qui en est fait.
+
+```js
+var myWorker = new SharedWorker('worker.js');
 
 myWorker.port.start();
 
@@ -66,36 +60,22 @@ second.onchange = function() {
 myWorker.port.onmessage = function(e) {
   result1.textContent = e.data;
   console.log('Message received from worker');
-}
- -

Pour l'exemple en complet, voir Basic shared worker example (run shared worker.)

- -

Spécifications

+} +``` - - - - - - - - - - - - - -
SpécificationStatutsCommentaire
{{SpecName('HTML WHATWG', "#dom-sharedworker", "SharedWorker()")}}{{Spec2('HTML WHATWG')}}
+Pour l'exemple en complet, voir [Basic shared worker example](https://github.com/mdn/simple-shared-worker) ([run shared worker](http://mdn.github.io/simple-shared-worker/).) -

Compatibilité des navigateurs

+## Spécifications +| Spécification | Statuts | Commentaire | +| ---------------------------------------------------------------------------------------- | -------------------------------- | ----------- | +| {{SpecName('HTML WHATWG', "#dom-sharedworker", "SharedWorker()")}} | {{Spec2('HTML WHATWG')}} | | +## Compatibilité des navigateurs -

{{Compat("api.SharedWorker.SharedWorker")}}

+{{Compat("api.SharedWorker.SharedWorker")}} -

Voir aussi

+## Voir aussi - +- L'interface {{domxref("SharedWorker")}} auquel il appartient. +- [Une autre démonstration de multiplication.](https://anlexn.github.io/shared-worker-mdn/) -- cgit v1.2.3-54-g00ecf