Import AttributesでJSONをimportする
importにwith { type: "json" }を付けると、JSONファイルをオブジェクトとして読み込めます。ブラウザとNode.jsで同じ書き方ができ、JSON以外は実行せずにエラーにします。Baseline 2025で使えます。
- Chrome123
- Edge123
- Firefox138
- Safari17.2
はじめに
JSONモジュールは、importにwith { type: 'json' }を付けて、JSONファイルをJavaScriptのオブジェクトとして読み込む仕組みです。with以降をImport Attributesと呼びます。Firefox 138が対応して、Baseline 2025に入りました。
読むたびにサーバーから最新の内容を取り直すときは、fetch()とresponse.json()を使います。JSONモジュールは、同じURLを何度インポートしても最初に読んだオブジェクトを返します。設定や辞書のように、コードと一緒に読み込んでawaitなしで使いたいJSONを、ブラウザでもNode.jsでも同じimport文で読めるのがJSONモジュールです。
Import Attributesの書き方
import data from './data.json' with { type: 'json' };
console.log(data); // { name: 'k8o', tags: [ 'css', 'js' ] }
console.log(data.name); // k8o
const { default: sameData } = await import('./data.json', { with: { type: 'json' } });
console.log(sameData === data); // true{ "name": "k8o", "tags": ["css", "js"] }Node.jsで動かすと、コメントのとおりに出ます。dataは、data.jsonの中身をそのまま持つオブジェクトです。動的なimport()では、第2引数のwithに同じ属性を書きます。2回目に読み込んでも、最初に読んだのと同じオブジェクトが返ります。
with { type: 'json' }を外すと、ブラウザでもNode.jsでも読み込みは失敗します。Node.jsはERR_IMPORT_ATTRIBUTE_MISSINGのエラーを出します。ブラウザはJavaScriptのモジュールとして読み込もうとするので、ChromeのコンソールにはExpected a JavaScript-or-Wasm module script but the server responded with a MIME type of "application/json"と出ます。
読み込めるのはdefaultだけで、import { name } from './data.json' with { type: 'json' }のように名前を指定するとSyntaxErrorになります。返るオブジェクトは凍結されていないので、書き換えると、同じJSONをインポートしたほかの場所からも書き換えた値が見えます。以前の書き方のassert { type: 'json' }は、今はSyntaxErrorになります。
JSON以外が返ったとき
with { type: 'json' }を付けると、ブラウザはレスポンスのMIMEタイプがJSONのものかを確かめます。Chromeでtext/htmlを返すURLを読み込むと、コンソールに次のエラーが出ます。
Failed to load module script: Expected a JSON module script but the server responded with a MIME type of "text/html". Strict MIME type checking is enforced for module scripts per HTML spec.
text/javascriptを返すURLを読み込んでも、どのブラウザでも読み込みは失敗し、中のコードは実行されません。属性を付けずに読み込めば、返ってきたJavaScriptはモジュールとして実行されます。JSONを返すはずのURLがJavaScriptを返しても、属性があればそのコードはページで動きません。
おわりに
設定や辞書のように取り直す必要の無いJSONは、with { type: 'json' }を付けたimportで読み込めます。ブラウザでもNode.jsでも同じ書き方ができ、JSON以外が返っても実行されません。