Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / JavaScript

WorkerGlobalScope.self — o objeto global do worker

A propriedade só de leitura WorkerGlobalScope.self devolve o objeto global do worker atual. Utilize self para aceder explicitamente às respetivas interfaces e tratar eventos; não é o objeto window nem permite aceder ao DOM da página.

Versão: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Sintaxe

self

WorkerGlobalScope.self é o nome usado na documentação para uma propriedade de instância, não uma chamada de método nem uma propriedade estática. No código de um worker, lê-se como self. Devolve o objeto global atual: DedicatedWorkerGlobalScope, SharedWorkerGlobalScope ou ServiceWorkerGlobalScope, consoante o tipo de worker. Por isso, self === self.self resulta em true.

A propriedade é só de leitura, mas isso não significa que o objeto devolvido esteja congelado: por exemplo, pode registar processadores de eventos através de self.addEventListener(...). Dentro de um worker, self não é o objeto Worker controlado pelo script que criou o worker. Um worker é executado no seu próprio contexto, sem window e sem acesso direto ao DOM da página.

A presença de self, por si só, não prova que o código esteja a ser executado num worker: o contexto de uma página também tem Window.self, que devolve um WindowProxy. WorkerGlobalScope.self é uma Web API definida pela norma HTML, não uma funcionalidade de uma edição específica de ECMAScript. A MDN assinala que esta propriedade está amplamente disponível desde julho de 2015; isso não significa, contudo, que todos os tipos de worker e as respetivas APIs tenham suporte idêntico. A presença do Node 24 num repositório não comprova o suporte desta API de browser.

Exemplos

<!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>

Resultado

true
true
undefined

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes