CSV テキストを渡すと、1行目をキーにして、行ごとに1つのオブジェクトを持つ JSON 配列を作ります。Excel や Google スプレッドシートからセル範囲をコピーするとタブ区切りのテキストになりますが、区切り文字は自動で判定するので、ファイルに保存せずそのまま貼り付けられます。
スプレッドシートで管理している商品一覧や翻訳表を、シードデータ、モックレスポンス、テストフィクスチャに移すのが典型的な使い方です。
CSV 欄に貼り付けます。.csv ファイルを入力欄にドロップしても内容を読み込めます。数値・真偽値を変換 をオンのままにすると、35 や true のような値が JSON の数値と真偽値になります。オフにするとすべての値が文字列のまま残ります。?types=0)に保存されるので、ブックマークしても保たれます。sku name price zip active
A-01 USB-C cable 9.9 04524 true
A-02 Charger 65W 35 01000 false
[
{
"sku": "A-01",
"name": "USB-C cable",
"price": 9.9,
"zip": "04524",
"active": true
},
{
"sku": "A-02",
"name": "Charger 65W",
"price": 35,
"zip": "01000",
"active": false
}
]シートからコピーしたタブ区切りのテキストです。price は数値に、active は真偽値になりましたが、04524 は先頭のゼロを保ったまま文字列として残るので、郵便番号が壊れません。
"Busan, Korea" のように引用符で囲まれた値の中の区切り文字や改行、"" とエスケープされた引用符も正しく読み取ります。007)、指数表記(1e3)、JavaScript の安全な範囲を超える整数は文字列のままです。true、false、null だけです。column2 などに、重複したヘッダーは name_2 になり、ヘッダーより列の多い行には columnN のキーが追加されます。シートで管理しているカテゴリ、料金プラン、FAQ の項目を、シードスクリプトや fixtures/*.json ファイル用の JSON 配列にできます。
バックエンドができる前に、シートにサンプル行をいくつか書いて変換すれば、MSW や json-server のレスポンスボディになります。
DBeaver や DataGrip の結果グリッドを CSV としてコピーして変換し、その配列をテストの期待値として貼り付けられます。
user.name のようなヘッダーがネストしたオブジェクトになることはありません。TRUE、Yes、空のセルは変換されません。空のセルは空文字列 "" になります。0012 のような値や 9007199254740991 を超える整数は、数値として解析すると値が変わってしまうため、意図的に文字列のままにしています。どうしても数値が必要なら、精度を管理できる自分のコード側で変換してください。
使えます。ヨーロッパのロケールで Excel が書き出す a;b;c 形式も1行目から判定します。その場合、1,5 のような小数点のカンマは数値にならず文字列のまま残ります。
値がダブルクォートで囲まれていれば、改行はその中に \n として残ります。Alt+Enter で編集したセルをコピーすると Excel が自動でその引用符を付けるので、そのまま貼り付けて大丈夫です。