AI di perangkat — profesional dan privat.

Dokumen

Escape dan Unescape JSON: Karakter yang Wajib Di-escape dan Cara Memperbaiki String yang Ter-escape Dua Kali

Penjelasan JSON escape dan unescape: karakter yang wajib di-escape di JSON, cara menaruh JSON di dalam string, dan cara memperbaiki tanda kutip yang ter-escape dua kali.

Diperbarui 8 November 2026Baca 8 menit

Untuk melakukan escape JSON pada sebuah teks, Anda menaruh garis miring terbalik di depan setiap tanda kutip ganda dan setiap garis miring terbalik, mengganti baris baru dan tab dengan \n, \r dan \t, lalu membungkus hasilnya dengan tanda kutip ganda. Unescape melakukan kebalikannya: \" kembali menjadi tanda kutip dan \n kembali menjadi baris baru yang sebenarnya. Hanya itu hampir seluruh aturannya, dan alat Escape Unescape String JSON menerapkannya dengan tepat, ke dua arah. Sebagian besar masalah muncul dari hal-hal di sekitar aturan itu: JSON yang ditempel di dalam string JSON lain, garis miring terbalik yang berlipat setiap kali sebuah nilai disimpan, dan karakter yang sah di JSON tetapi merusak tempat Anda menempelkannya. Panduan ini membahas masing-masing kasus tersebut.

Apa arti escape di JSON, dan karakter mana yang membutuhkannya

String JSON diawali dan diakhiri tanda kutip ganda. Apa pun di dalamnya yang bisa disangka sebagai akhir string atau awal sebuah escape harus ditulis dengan cara lain. Standar JSON (RFC 8259) mewajibkan escape untuk tepat tiga kelompok karakter: tanda kutip ganda, garis miring terbalik, dan semua karakter kontrol dari U+0000 sampai U+001F, termasuk baris baru dan tab. Selain itu, termasuk huruf beraksen, emoji, apostrof dan garis miring biasa, boleh ditulis apa adanya.

KarakterDitulis di JSON sebagaiWajib?
Tanda kutip ganda "\"Ya, kalau tidak string akan berakhir
Garis miring terbalik \\\Ya, kalau tidak sebuah escape dimulai
Baris baru (line feed)\nYa, baris baru asli di dalam string tidak sah
Carriage return\rYa
Tab\tYa
Backspace, form feed\b, \fYa
Kontrol lain U+0000 sampai U+001F\u0000 sampai \u001fYa, tidak ada bentuk pendeknya
Garis miring // atau \/Tidak, keduanya sah
Non-ASCII seperti é atau 😀apa adanya, atau \u00e9 dan pasangan D83D DE00Tidak, keduanya sah
Apostrof 'apa adanyaTidak, dan \' bukan escape yang sah

Baris terakhir menjebak banyak orang. JavaScript dan Python menerima \' di dalam string, jadi terasa wajar, tetapi JSON tidak mendefinisikannya. Parser yang bertemu \' berhenti dengan galat. Di JSON apostrof sama sekali tidak perlu di-escape, dan tanda kutip tunggal tidak pernah boleh dipakai untuk membungkus string.

Escape atau unescape: mana yang Anda perlukan

Situasi AndaArahHasil yang didapat
Kueri SQL beberapa baris, sertifikat, atau template harus menjadi satu nilai JSONEscapeSatu baris dengan \n di tempat baris baru tadi
String yang penuh tanda kutip harus masuk ke file konfigurasi atau fixture pengujianEscapeSetiap " ditulis sebagai \"
Baris log atau field API terbaca sebagai satu deretan \n dan \"UnescapeTeks yang bisa dibaca, dengan baris baru yang sebenarnya
Sebuah field berisi satu dokumen JSON utuh dalam bentuk stringUnescapeDokumen di dalamnya, siap untuk Formatter JSON
Anda ingin memastikan teks yang di-escape berisi apa yang Anda kiraEscape, lalu TukarPerjalanan bolak-balik yang harus mengembalikan teks asli persis sama

Escape bukan enkripsi dan bukan kompresi. Ia hanya mengubah cara karakter khusus ditulis agar parser membacanya sebagai teks. Jika Anda perlu mengubah data biner seperti gambar menjadi teks, itu pekerjaan lain, dijelaskan di apa itu encoding Base64. Jika teksnya akan masuk ke alamat web, yang dibutuhkan adalah percent-encoding dengan URL encoder.

Cara escape atau unescape string JSON, langkah demi langkah

1

Pilih arah

Buka alat escape JSON dan pilih Escape untuk mengubah teks biasa menjadi literal string JSON, atau Unescape untuk mengubah string JSON kembali menjadi teks.

2

Masukkan teks Anda

Tempel ke kotak lalu tekan Gunakan teks ini, atau jatuhkan file .json, .txt, .log, .ndjson atau file teks serupa ke area unggah. UTF-8 dan UTF-16 sama-sama dikenali.

3

Atur opsinya

Untuk Escape, Bungkus hasil dengan kutipan aktif secara bawaan; matikan jika Anda akan menempel hasilnya di antara tanda kutip yang sudah ada di kode Anda. Tiga opsi lainnya dijelaskan di bawah. Untuk Unescape, biarkan Lapisan yang dikupas pada Otomatis (sampai 10) kecuali Anda ingin berhenti di tengah jalan.

4

Jalankan dan periksa hitungannya

Tekan Escape atau Unescape. Hasilnya muncul di samping sumber, lengkap dengan jumlah karakter dan byte serta rasio pertumbuhan, yang penting ketika nilai itu harus muat di sebuah kolom atau di bawah batas ukuran request.

5

Salin, unduh, atau tukar

Salin hasilnya, unduh sebagai file teks, atau tekan Tukar untuk mengirimnya kembali ke input dengan arah sebaliknya dan memastikan teks asli Anda kembali utuh.

Ubah teks menjadi string JSON atau dekode kembali, dengan lapisan bersarang dikupas otomatis. Gratis: satu file atau teks tempelan hingga 10 MB, dengan semua opsi. Pro: tanpa batas ukuran tetap dan hingga 20 file sekaligus, diunduh sebagai satu ZIP. Semuanya berjalan di perangkat Anda, bukan di server kami.

Escape atau unescape JSON

Menaruh JSON di dalam string JSON

Kadang satu dokumen JSON utuh harus dikirim sebagai satu string: isi webhook yang disimpan di kolom database, objek pengaturan yang melewati antrean yang hanya menerima teks, atau field pesan pada sebuah event log. Untuk itu, Anda melakukan escape pada dokumennya. Objek {"name":"Ana"} menjadi string "{\"name\":\"Ana\"}". Setiap tanda kutip di dalamnya mendapat satu garis miring terbalik, dan keseluruhannya mendapat sepasang tanda kutip di luar.

Sebelum melakukan escape pada sebuah dokumen, pastikan dokumen itu valid, karena objek yang kehilangan satu koma akan menghasilkan string yang sepenuhnya sah tetapi berisi dokumen rusak. Periksa dulu dengan Validator JSON. Jika ukuran penting, hapus indentasi dengan Minifier JSON sebelum escape: setiap baris baru di dokumen yang diformat menjadi \n dua karakter dan spasi indentasi tetap ada, sehingga dokumen terformat yang di-escape jauh lebih besar daripada dokumen minified yang di-escape.

Sebaliknya, ketika sebuah API mengembalikan field yang nilainya diawali "{\", Anda sedang melihat dokumen yang tertanam. Lakukan unescape sekali dan Anda mendapatkan JSON asli kembali, yang lalu bisa diformat dan dibaca.

Double escape: mengapa garis miring terbalik terus berlipat

Setiap kali sebuah nilai di-escape, setiap garis miring terbalik yang sudah ada digandakan dan setiap tanda kutip mendapat satu lagi. Baris baru yang berupa \n setelah satu putaran menjadi \\n setelah dua putaran dan \\\\n setelah tiga putaran. Jika di-unescape sekali, hasilnya masih tampak ter-escape, dan karena itulah orang mengira alatnya tidak bekerja. Alatnya bekerja: ia melepas satu lapisan dari beberapa lapisan.

Biarkan Lapisan yang dikupas pada Otomatis dan alat ini terus berjalan selama hasilnya masih berupa string JSON bertanda kutip, hingga sepuluh lapisan, lalu memberi tahu berapa lapisan yang dilepas. Pilih angka 1 sampai 10 jika ingin berhenti di lapisan dalam, misalnya untuk menyerahkan dokumen tertanam ke formatter alih-alih mendekodenya lebih jauh. Teks biasa yang kebetulan berisi \n tidak pernah dikupas, karena sebuah lapisan hanya dilepas jika sisanya benar-benar terbaca sebagai string JSON.

Penyebab umum double escape, agar Anda bisa memperbaikinya dari sumbernya:

  • Serialisasi dua kali. Memanggil JSON.stringify di JavaScript atau json.dumps di Python pada sesuatu yang sudah berupa string JSON akan membungkusnya lagi. Serialisasikan objek sekali saja, di langkah terakhir.
  • Library logging. Logger terstruktur melakukan escape pada pesan, dan sebagian pipeline melakukan escape pada seluruh event sekali lagi saat meneruskannya.
  • Escape manual lalu lewat kode. Menambahkan \" sendiri lalu meneruskan teks ke serializer menghasilkan \\\".
  • Menyalin dari debugger atau konsol. Sebagian konsol menampilkan string dalam bentuk ter-escape. Menyalin tampilan itu lalu melakukan escape lagi menambah satu lapisan.
  • Path Windows. C:\Users\Ana harus ditulis C:\\Users\\Ana di JSON. Menempelnya tanpa escape menghasilkan \U, yang bukan escape sah, dan melakukan escape dua kali menghasilkan empat garis miring terbalik per pemisah.

Escape sesuai tujuan string

Semua yang berikut tetap menghasilkan JSON yang sah. Tiga opsi tambahan di alat ini ada karena tempat tujuan kadang peduli.

OpsiAktifkan ketikaBiaya
Escape non-ASCII menjadi \uXXXXNilainya melewati sistem yang tidak andal menangani UTF-8, atau Anda ingin ASCII murni di version controlé bertambah dari 2 byte menjadi 6; emoji dari 4 byte menjadi 12, sebagai dua escape
Escape garis miring menjadi \/String berada di dalam blok script HTML, tempat </script> di dalam string akan menutup tag terlalu cepatSatu byte tambahan per garis miring
Escape pemisah baris (U+2028, U+2029)Literal ditempel ke kode JavaScript untuk mesin lama, tempat dua karakter tak terlihat ini dulu menjadi galat sintaksEnam byte, bukan tiga, per karakter

Menempel ke kode adalah kasus tersendiri. Literal string JSON biasanya juga string yang sah di JavaScript, Python dan Go, jadi Anda bisa menempel hasil escape di antara tanda kutip Anda sendiri dengan opsi kutipan dimatikan. Di shell, bungkus isi JSON dengan tanda kutip tunggal dan tanda kutip ganda di dalamnya tidak perlu di-escape lagi; di Command Prompt Windows tidak ada string bertanda kutip tunggal, sehingga setiap tanda kutip ganda di dalamnya harus ditulis \" untuk baris perintah, yang merupakan lapisan kedua yang terpisah di atas lapisan JSON.

Saat unescape gagal: arti pesan galatnya

PesanPenyebab umumPerbaikan
String tidak pernah ditutupNilainya terpotong oleh batas panjang log atau salinan yang tidak lengkapTempel nilai utuhnya, atau tambahkan tanda kutip penutup
Urutan escape tidak dikenalGaris miring terbalik di depan huruf yang tidak didefinisikan JSON, seperti \' atau \U di path WindowsGandakan garis miring terbaliknya, atau lakukan escape pada teks aslinya
Escape \u tidak lengkap\u tidak diikuti tepat empat digit heksadesimal\u12 tidak sah; tulis \u0012
Karakter kontrol mentahAda baris baru atau tab asli di dalam string, sering setelah menyalin dari terminalJalankan Escape pada teks itu
Ada isi tambahan setelah stringDua string berdampingan, atau ada teks setelah tanda kutip penutupKonversi satu nilai setiap kali
Itu dokumen JSON, bukan stringAnda menempel sebuah objek atau arrayGunakan formatter atau validator; Unescape bekerja pada satu string

Setiap pesan menyebutkan baris dan kolom serta menampilkan teks di sekitarnya, sehingga pada baris log yang panjang Anda bisa melihat persis garis miring terbalik mana yang bermasalah tanpa harus mencarinya.

Pertanyaan umum

Bagaimana cara escape tanda kutip ganda di JSON?

Taruh garis miring terbalik di depan setiap tanda kutip, sehingga " menjadi \". Setiap garis miring terbalik yang sudah ada di teks harus digandakan lebih dulu, kalau tidak hasilnya akan dibaca berbeda. Menempel teks ke mode Escape melakukan keduanya dan membungkus hasilnya dengan tanda kutip.

Bagaimana cara unescape string JSON secara online?

Pilih Unescape, tempel string dengan atau tanpa tanda kutipnya, lalu jalankan. Biarkan pengaturan lapisan pada Otomatis jika nilainya mungkin di-escape lebih dari sekali; alat ini memberi tahu berapa lapisan yang dilepas.

Mengapa JSON saya punya garis miring terbalik di depan setiap tanda kutip?

Nilainya disimpan sebagai string, bukan objek, biasanya karena diserialisasi dua kali. Lakukan unescape untuk mendapatkan JSON di dalamnya, lalu perbaiki kode yang melakukan serialisasi agar hanya berjalan sekali.

Bisakah saya memakai tanda kutip tunggal atau \' di JSON?

Tidak. String JSON harus memakai tanda kutip ganda, dan \' bukan escape yang sah. Apostrof di dalam string bertanda kutip ganda boleh ditulis apa adanya dan tidak memerlukan garis miring terbalik.

Apakah garis miring perlu di-escape di JSON?

Tidak. / dan \/ sama-sama sah dan artinya sama. Escape hanya membantu ketika JSON diletakkan di dalam tag script HTML, tempat teks </script> akan menutup tag tersebut.

Seberapa besar teks yang bisa di-escape secara gratis?

Versi gratis menangani satu file atau teks tempelan hingga 10 MB, dengan semua opsi dan semua kedalaman unescape. Pro menghapus batas tetap, bekerja sejauh kemampuan perangkat Anda, dan menerima hingga 20 file sekaligus.

Baca juga

Lainnya tentang Dokumen →