CKTIS / JavaScript
WorkerGlobalScope.self — l’objet global du worker
La propriété en lecture seule WorkerGlobalScope.self renvoie l’objet global du worker actuel. Utilisez self pour accéder explicitement à ses interfaces et gérer ses événements ; ce n’est ni l’objet window ni un accès au DOM de la page.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
selfWorkerGlobalScope.self est le nom documentaire d’une propriété d’instance, et non un appel de méthode ou une propriété statique. Dans le code d’un worker, on la lit sous la forme self. Elle renvoie l’objet global actuel : DedicatedWorkerGlobalScope, SharedWorkerGlobalScope ou ServiceWorkerGlobalScope, selon le type de worker. Ainsi, self === self.self donne true.
La propriété est en lecture seule, mais cela ne signifie pas que l’objet renvoyé est figé : vous pouvez, par exemple, enregistrer des gestionnaires d’événements avec self.addEventListener(...). Dans un worker, self n’est pas l’objet Worker contrôlé par le script qui a créé le worker. Un worker s’exécute dans son propre contexte, sans window ni accès direct au DOM de la page.
La présence de self ne prouve pas à elle seule que le code s’exécute dans un worker : un contexte de page possède également Window.self, qui renvoie un WindowProxy. WorkerGlobalScope.self est une API Web définie par la norme HTML, et non une fonctionnalité d’une édition particulière d’ECMAScript. MDN indique que cette propriété est largement disponible depuis juillet 2015 ; cela ne signifie toutefois pas que tous les types de workers et leurs API bénéficient d’une prise en charge identique. La présence de Node 24 dans un dépôt ne démontre pas la prise en charge de cette API de navigateur.
Exemples
<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>WorkerGlobalScope.self</title>
</head>
<body>
<script>
const source = `
self.postMessage([
self === self.self,
self instanceof WorkerGlobalScope,
typeof window
]);
`;
const url = URL.createObjectURL(new Blob([source], { type: 'text/javascript' }));
const worker = new Worker(url);
worker.addEventListener('message', ({ data }) => {
for (const result of data) console.log(String(result));
worker.terminate();
URL.revokeObjectURL(url);
}, { once: true });
</script>
</body>
</html>Résultat
true true undefined
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.