É comum eu ver em cursos online, artigos e tutoriais pela internet, códigos em Node.js que posuem recuros de importar arquivos JSON locais para dentro do código para serem manipulados, usados, testados, etc... Nestes exemplos, ele usam o CommonJS para fazer a importação do JSON, usando o require()
. Algo como (por exemplo):
Estrutura de pasta:
|
\_ test.json
|
\_ index.js
Conteúdo do JSON:
{
"foo": "baz"
}
Código Node.js:
const json = require('./test.json');
// exibe: { foo: 'baz' }
console.log(json);
O problema é que essa metodologia não funciona quando se usa ESM (ECMAScript modules). O código abaixo vai retornar um erro:
Para quem não sabe, em versões recentes do Node.js você pode usar ESM configurando o package.json definindo "type": "module"
.
import json from './test.json';
console.log(json);
Erro:
node:internal/process/esm_loader:74
internalBinding('errors').triggerUncaughtException(
^
TypeError [ERR_UNKNOWN_FILE_EXTENSION]: Unknown file extension ".json" for /home/cmt-cardeal/<path-irrelevante>/test.json
at new NodeError (node:internal/errors:363:5)
....
}
Se eu tentar interoperar CommonJS com ESM, ou seja, usar o require
dentro de um arquivo definido como ESM, eu tenho um outro erro no terminal:
file:///home/cmt-cardeal/<path-irrelevante>/index.js:3
const json = require('./test.json');
^
ReferenceError: require is not defined in ES module scope, you can use import instead
This file is being treated as an ES module because it has a '.js' file extension and '/home/cmt-cardeal/<path-irrelevante>/package.json' contains "type": "module". To treat it as a CommonJS script, rename it to use the '.cjs' file extension.
...
Explicado isto, eu queria saber:
- Como importar o conteúdo do JSON dentro de um arquivo definido como ESM sem usar
FS
e sem ter que renomear o arquivo para a extensão.cjs
?
Minha versão do Node.js ao elaborar esta pergunta: v16.0.0
Relembrando: JavaScript: Diferenças entre import e require