node · JavaScript
A mensagem
SyntaxError: Cannot use import statement outside a module
O que significa
O Node ou o navegador leram aquele arquivo como um script CommonJS, e dentro havia a palavra-chave ESM import. Um arquivo .js é CommonJS a menos que o package.json diga o contrário, e no navegador acontece o mesmo quando a tag <script> não tem type="module". npm pkg set type=module declara o pacote inteiro como ESM e resolve, mas a partir dali todo .js do pacote perde require e __dirname, então os arquivos CommonJS restantes também precisam migrar — se você só quer converter um arquivo, renomeá-lo para .mjs é a mudança mais estreita e segura.
A correção
npm pkg set type=module- 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 “SyntaxError: Cannot use import statement outside a module”?
O Node ou o navegador leram aquele arquivo como um script CommonJS, e dentro havia a palavra-chave ESM import. Um arquivo .js é CommonJS a menos que o package.json diga o contrário, e no navegador acontece o mesmo quando a tag <script> não tem type="module". npm pkg set type=module declara o pacote inteiro como ESM e resolve, mas a partir dali todo .js do pacote perde require e __dirname, então os arquivos CommonJS restantes também precisam migrar — se você só quer converter um arquivo, renomeá-lo para .mjs é a mudança mais estreita e segura.
Q. Como corrigir?
npm pkg set type=module — antes de rodar, veja acima o que este comando descarta.
Q. Qual ferramenta imprime isso?
node. Fica em JavaScript e a mensagem tem 8 palavras.