Penggabungan JSON

Rekomendasi Terkait

Apa itu JSON Merge (Penggabungan JSON)?

Kasus penggunaan

• Menggabungkan respons API dari beberapa microservice menjadi struktur JSON terpadu untuk digunakan frontend
• Mengagregasi file konfigurasi berlapis base/dev/prod, menghasilkan konfigurasi final dengan penimpaan berbasis lingkungan
• Menggabungkan, mendeduplikasi, dan melengkapi beberapa file terjemahan i18n per bahasa menjadi kamus lengkap
• Menggabungkan beberapa array data mock atau beberapa respons API paginasi menjadi dataset lengkap
• Komponen frontend menggabungkan konfigurasi default + konfigurasi kustom pengguna + konfigurasi eksperimen A/B jarak jauh
• Dalam migrasi data, menggabungkan file ekspor JSON dari beberapa sistem sumber menjadi format terpadu untuk downstream

Cara Penggunaan

1. Tempelkan 2 hingga N segmen JSON yang perlu digabungkan secara berurutan ke kolom input sebelah kiri (default 2 kolom), atau klik tombol "+" untuk menambahkan lebih banyak input
2. Pilih strategi penggabungan pada dropdown toolbar: Deep Merge / Shallow Merge / Array Concat / Array Replace
3. Klik tombol "Gabungkan", kolom output sebelah kanan akan menampilkan hasil penggabungan yang terformat; jika terdapat kesalahan sintaksis pada input, nomor baris dan pesan error spesifik akan ditampilkan
4. Setelah memastikan hasil benar, klik "Salin" untuk menyalin hasil penggabungan ke clipboard, atau klik "Unduh" untuk menyimpannya sebagai file merged.json guna melanjutkan proses formatting, validasi Schema, dan penanganan lanjutan lainnya

Fitur

• 4 strategi penggabungan: Deep Merge / Shallow Merge / Array Concat / Array Replace, dapat diubah sekali klik untuk memenuhi berbagai skenario bisnis
• Mendukung 2 hingga N segmen JSON: tersedia 2 kolom input secara default, klik tombol "+" untuk menambahkan lebih banyak sumber JSON secara dinamis, fleksibel untuk agregasi multi-sumber
• Penggabungan rekursif mendalam: memproses objek bertingkat multi-level secara cerdas, menangani konflik leaf node sesuai strategi yang dipilih, mempertahankan semua field yang valid
• Resolusi konflik yang fleksibel: konflik level teratas dieksekusi sesuai strategi terpilih; konflik objek bertingkat memasuki deep merge; konflik array dibedakan berdasarkan arrayConcat/arrayReplace
• Output terformat seragam: hasil penggabungan ditampilkan dengan indentasi 2 spasi, memudahkan peninjauan manual dan penyalinan langsung ke alat downstream
• Penggabungan real-time: tempelkan JSON lalu klik "Gabungkan" untuk mendapatkan hasil; jika terjadi error, nomor baris JSON dan pesan error spesifik akan ditampilkan
• Diproses secara lokal untuk menjaga privasi: parsing, penggabungan, dan formatting sepenuhnya dilakukan di browser lokal, konten input tidak dikirim ke server mana pun
• Integrasi mulus dengan alat downstream: hasil penggabungan dapat disalin sekali klik ke alat JSON Format, Schema Validator, Code Generator, dan lainnya untuk diproses lebih lanjut

Contoh Kode

// npm install lodash.merge
import merge from 'lodash.merge';

const a = { user: { name: 'Alice', age: 28 }, tags: ['admin'] };
const b = { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] };

// Deep Merge: objek bertingkat digabungkan secara rekursif, leaf node ditimpa input terbaru
const deep = merge({}, a, b);
console.log(deep);
// => { user: { name: 'Alice', age: 29, email: 'a@x.com' }, tags: ['admin', 'editor'] }

// Shallow Merge: key level teratas ditimpa seluruhnya, tidak memasuki level bertingkat
const shallow = Object.assign({}, a, b);
console.log(shallow);
// => { user: { email: 'a@x.com', age: 29 }, tags: ['editor'] }

# pip install mergedeep
from mergedeep import merge

a = {"user": {"name": "Alice", "age": 28}, "tags": ["admin"]}
b = {"user": {"email": "a@x.com", "age": 29}, "tags": ["editor"]}

# Deep Merge
result = merge(a, b)
print(result)
# => {'user': {'name': 'Alice', 'age': 29, 'email': 'a@x.com'}, 'tags': ['admin', 'editor']}

# Catatan: mergedeep secara default menggabungkan array, string/angka ditimpa
# Jika ingin array ditimpa, tambahkan strategy='override'

# Menggabungkan beberapa array JSON menjadi satu array panjang
jq -s 'add' a.json b.json c.json

# Menggabungkan beberapa objek JSON secara rekursif (jq 1.6+)
jq -s 'reduce .[] as $item ({}; . * $item)' a.json b.json

# Shallow Merge: menimpa key level teratas b ke a
jq -s '.[0] * .[1]' a.json b.json

# Setelah penggabungan array, hanya simpan field id yang telah dideduplikasi
jq -s '[.[].items[]] | unique_by(.id)' a.json b.json

Pertanyaan Umum

Pemecahan Masalah

Glosarium

JSON Merge

Operasi menggabungkan dua atau lebih objek JSON menjadi satu objek baru berdasarkan aturan tertentu; tantangan utamanya adalah "strategi resolusi saat terjadi konflik nama key".

Deep Merge / Penggabungan Dalam

Strategi penggabungan yang memasuki objek bertingkat secara rekursif dan menggabungkan setiap leaf node; jika kedua sisi adalah plain object maka dilakukan rekursi, selainnya ditangani dengan penimpaan.

Shallow Merge / Penggabungan Dangkal

Strategi yang hanya menggabungkan key level teratas, key dengan nama sama akan ditimpa seluruhnya; dalam JavaScript ekuivalen dengan `Object.assign({}, a, b)`.

Array Concat / Penyambungan Array

Salah satu strategi penggabungan array: menggabungkan beberapa array menjadi satu array panjang dengan mempertahankan urutan semua elemen; sering digunakan untuk agregasi respons API.

Array Replace / Penggantian Array

Salah satu strategi penggabungan array: array dengan nama key yang sama akan ditimpa seluruhnya oleh input terbaru; sering digunakan untuk penimpaan konfigurasi.

Object.assign

Method bawaan JavaScript yang menyalin semua properti enumerable milik sendiri dari satu atau lebih objek sumber ke objek target secara shallow (dangkal); merupakan implementasi standar de facto untuk shallow merge.

lodash.merge

Fungsi deep merge yang disediakan oleh library Lodash, merupakan implementasi deep merge yang paling banyak digunakan dalam ekosistem Node.js; array digabungkan (bukan ditimpa).

mergedeep (Python)

Library deep merge untuk ekosistem Python, instal dengan pip install mergedeep; mendukung parameter strategy untuk mengontrol perilaku penggabungan/penimpaan array.

jq -s 'add'

Perintah jq untuk menjumlahkan beberapa array JSON menjadi satu array tunggal; untuk menggabungkan beberapa objek JSON gunakan `reduce .[] as $item ({}; . * $item)`.

BFF (Backend for Frontend)

Lapisan agregasi yang terletak antara frontend dan layanan backend dalam arsitektur microservice; sering kali perlu menggabungkan respons JSON dari beberapa layanan menjadi respons terpadu, merupakan skenario klasik JSON Merge.

Perbandingan 4 Strategi JSON Merge

Tabel Perbandingan Implementasi JSON Merge yang Umum

Authoritative References

• MDNObject.assign - Dokumentasi Web MDN
• LodashDokumentasi Resmi Lodash _.merge
• jqManual Resmi jq - reduce dan add
• IETFSpesifikasi Resmi JSON (RFC 8259)