node · JavaScript
A mensagem
ReferenceError: window is not defined
O que significa
O código rodou dentro do Node no servidor, não num navegador. O Node não tem window, nem document, nem localStorage, então tocar window enquanto um módulo é carregado num framework que renderiza primeiro no servidor, como Next.js ou Nuxt, para aqui — muitas vezes é uma única linha fora do componente, ou o próprio import de uma biblioteca só de navegador. Se o trabalho é só de navegador, proteja com typeof window !== 'undefined' ou, melhor, mova para dentro de useEffect, que só roda no navegador. Quando toda uma biblioteca é só de navegador, o Next.js pode excluí-la do render do servidor com dynamic(() => import('./C'), { ssr: false }) — ao custo de aquela parte não aparecer no HTML gerado no servidor.
A correção
Não há um comando de uma linha. A explicação diz o que verificar.
- Impresso por
- node
- JavaScript
- 15
Erros de navegador e de Node costumam dizer o que quebrou e não por que o valor ficou assim — você leu undefined, não era uma função, não era JSON — então o lugar de corrigir está acima da linha que estourou, e calar só aquela linha com ?. e valores padrão faz o mesmo problema reaparecer mais longe, numa forma mais difícil de reconhecer.
Como ler uma mensagem de erro
- Leia da primeira linha para baixo. Quanto mais abaixo, mais são as tripas da ferramenta; a causa costuma estar no topo.
- Se há arquivo e número de linha, comece ali — não o quadro superior da pilha, e sim a linha mais alta que nomeie um arquivo seu.
- Pesquise a mensagem literal, mas tire primeiro seus caminhos e nomes de variáveis: é isso que impede a busca de casar.
- A mesma condição é redigida de formas diferentes conforme a versão. Se os resultados não batem, some o número da versão.
- Antes de colar uma correção, veja o que ela descarta. Algumas não dá para desfazer.
Perguntas frequentes
Q. O que significa “ReferenceError: window is not defined”?
O código rodou dentro do Node no servidor, não num navegador. O Node não tem window, nem document, nem localStorage, então tocar window enquanto um módulo é carregado num framework que renderiza primeiro no servidor, como Next.js ou Nuxt, para aqui — muitas vezes é uma única linha fora do componente, ou o próprio import de uma biblioteca só de navegador. Se o trabalho é só de navegador, proteja com typeof window !== 'undefined' ou, melhor, mova para dentro de useEffect, que só roda no navegador. Quando toda uma biblioteca é só de navegador, o Next.js pode excluí-la do render do servidor com dynamic(() => import('./C'), { ssr: false }) — ao custo de aquela parte não aparecer no HTML gerado no servidor.
Q. Como corrigir?
Não há comando de uma linha. A explicação acima diz o que verificar.
Q. Qual ferramenta imprime isso?
node. Fica em JavaScript e a mensagem tem 5 palavras.