Worker()

Le constructeur Worker() crée un objet Worker qui exécute le script à l'URL spécifiée. Ce script doit obéir à la same-origin policy.

Note : Il y a un désaccord entre les éditeurs de navigateur sur la question de savoir si une donnée URI relève ou non de la même origine. Bien que Gecko 10.0 et suivant accepte les données URIs, ce n'est pas le cas dans tous les autres navigateurs.

Syntaxe

js
var myWorker = new Worker(aURL, options);

Arguments

aURL

Est un DOMString représentant l'URL du script que le worker va exécuter. Il doit obéir à la same-origin policy.

options Facultatif

Un objet contenant des propriétés pour définir les options. Les propriétés suivantes sont valables:

  • type: Une DOMString définissant le type de worker à créer. The valeur peuvent être classic ou module. Si cette prpriété n'est pas définie, la valeur sera classic.
  • credentials : une DOMString définissant le type de politique d'origine à utiliser pour le worker. Les valeurs peuvent être omit, same-origin ou include. Si cette propriété n'est pas définie, ou que type est défini à classic, la valeur sera classic.
  • name: Une DOMString définissant un identifiant pour l'environment du worker DedicatedWorkerGlobalScope, souvent utilisé pour le débogage.

Exceptions

  • SecurityError est levé si le document n'est pas autorisé à démarer des workers; par exemple si l'URL à une syntaxe invalide ou que la politique d'origine n'est pas respectée.
  • NetworkError est levé si le type MIME du script du worker est incorect. Il doit toujours être défini à text/javascript.
  • SyntaxError est levé si l'URL ne peut pas être analysée.

Exemple

L'extrait de code suivant illustre la création d'un objet Worker en utilisant le constructeur Worker() et l'usage qui peut alors en être fait :

js
var myWorker = new Worker("worker.js");

first.onchange = function () {
  myWorker.postMessage([first.value, second.value]);
  console.log("Message envoyé au worker");
};

Pour un exemple complet, consultez notre exemple basique d'un worker dédié (lancer le worker dédié).

Spécifications

Specification
HTML
# dom-worker-dev

Compatibilité des navigateurs

Report problems with this compatibility data on GitHub
desktopmobileserver
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
Deno
Node.js
Worker() constructor
Support for ECMAScript modules
Strict MIME type checks for worker scripts
options.name parameter
options.type parameter

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
No support
No support
See implementation notes.

Voir aussi

L'interface Worker auquel il appartient.