本文へ移動

k8o

お問い合わせ

255文字以内で入力してください

GitHub Issueからのお問い合わせもお待ちしております。

Blog

公開: 2025年5月21日(水)更新: 2026年11月9日(月)約3分で読めます

Import AttributesでJSONをimportする

importにwith { type: "json" }を付けると、JSONファイルをオブジェクトとして読み込めます。ブラウザとNode.jsで同じ書き方ができ、JSON以外は実行せずにエラーにします。Baseline 2025で使えます。

Newly availableJSON import attributes2025年〜
  • 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の書き方

main.mjs
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

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以外が返っても実行されません。