Penguji JSONPath Gratis — Evaluasi Kueri Online

Apa Itu Penguji JSONPath?

// The expression you build in this tester maps straight onto the
// RFC 9535 reference library used under the hood.
import { query, paths } from 'jsonpath-rfc9535';

const document = {
  store: {
    book: [
      { title: 'Sayings of the Century', author: 'Nigel Rees', price: 8.95 },
      { title: 'Sword of Honour', author: 'Evelyn Waugh', price: 12.99 },
      { title: 'Moby Dick', author: 'Herman Melville', price: 8.99 },
      { title: 'The Lord of the Rings', author: 'J. R. R. Tolkien', price: 22.99 }
    ]
  }
};

// Values: query(document, path) returns the matched values directly.
const titles = query(document, '$.store.book[*].title');
// → ['Sayings of the Century', 'Sword of Honour', 'Moby Dick', 'The Lord of the Rings']

// Filter: books cheaper than 10.
const cheap = query(document, '$.store.book[?(@.price < 10)].title');
// → ['Sayings of the Century', 'Moby Dick']

// Normalized paths: paths(document, path) returns where each match lives.
const authorPaths = paths(document, '$..author');
// → ["$['store']['book'][0]['author']", "$['store']['book'][1]['author']", ...]

// RFC 9535 functions like length() are used INSIDE filters, not as a segment.
const longTitles = query(document, '$.store.book[?length(@.title) > 15]');
// → the two books whose title is longer than 15 characters

Fitur Utama

Contoh yang Dikerjakan

$.store.book[*].title

["Sayings of the Century", "Sword of Honour", "Moby Dick", "The Lord of the Rings"]

$.store.book[?(@.price < 10)].title

["Sayings of the Century", "Moby Dick"]

$..author

["Nigel Rees", "Evelyn Waugh", "Herman Melville", "J. R. R. Tolkien"]

$.store.book[0:2].title

["Sayings of the Century", "Sword of Honour"]

$.store.book[?length(@.title) > 15]

[{"title": "Sayings of the Century", "author": "Nigel Rees", "price": 8.95}, {"title": "The Lord of the Rings", "author": "J. R. R. Tolkien", "price": 22.99}]

$.store.book[0]['title','author']

["Sayings of the Century", "Nigel Rees"]

Cara Menggunakan Penguji JSONPath

1. 1

   Tempel atau unggah JSON Anda

   Jatuhkan JSON ke kotak masukan, tempelkan, atau klik Unggah untuk memuat berkas .json / .txt dari disk. Format JSON mengindentasi ulang dokumen. JSON tidak valid ditandai sebaris dengan pesan parser sebelum Anda mengkueri.

2. 2

   Pilih sebuah mesin

   RFC 9535 (standar IETF 2024, tanpa eval) adalah default. Beralih ke Klasik (Goessner) saat Anda menjalankan ekspresi yang disalin dari alat lebih lama seperti jsonpath.com agar hasilnya cocok dengan apa yang Anda lihat di sana.

3. 3

   Ketik ekspresi JSONPath Anda

   Awalan $ sudah ditampilkan untuk Anda. Mulailah dengan path anak seperti .store.book[*].title, indeks seperti [0], penurunan rekursif seperti ..author, atau filter seperti [?(@.price < 10)]. Hasil diperbarui secara langsung saat Anda mengetik.

4. 4

   Beralih tampilan hasil

   Values menunjukkan larik JSON dari nilai yang cocok. Paths menunjukkan path ternormalisasi setiap kecocokan seperti $['store']['book'][0]['title']. Both menunjukkan keduanya berdampingan sehingga Anda dapat memetakan setiap nilai ke lokasi persisnya dalam dokumen.

5. 5

   Salin hasil atau bagikan tautan permanen

   Salin hasil menempatkan keluaran di papan klip Anda. Salin tautan mengodekan JSON, ekspresi, mesin, dan tampilan ke dalam hash URL (tanpa unggah) sehingga kolega dapat mereproduksi kueri persis secara lokal di mesin mereka sendiri.

Kesalahan JSONPath Umum

store.book[*].title  →  invalid (no root)

$.store.book[*].title  →  selects every title

$.store.book[0:2]  →  first TWO books, not three

$.store.book[0:3]  →  first three books (indices 0,1,2)

Classic filter run under RFC 9535  →  parse error or unexpected nodes

Switch engine to Classic (Goessner)  →  reproduces the original result

$.store.book.length()  →  parse error (not a valid RFC 9535 segment)

$.store.book[?length(@.title) > 15]  →  books with a title over 15 chars

$.store.book[?($.price < 10)]  →  wrong scope

$.store.book[?(@.price < 10)]  →  books under 10

$[store][book]  →  invalid bracket selectors

$['store']['book']  →  same as $.store.book

$..price  →  every price anywhere in the tree

$.store.book[*].price  →  only book prices

Siapa yang Menggunakan Alat Ini

Ekstrak Bidang dari Respons API

Tarik ID permintaan, atribut sumber daya tersarang, atau daftar nama dari payload JSON tanpa menulis kode penelusuran. Bangun path di sini terhadap respons sampel, konfirmasi ia mengembalikan persis node yang Anda inginkan di tampilan Values, lalu tempel ekspresi yang divalidasi ke aplikasi atau pengujian Anda.

Tulis Asersi untuk Pengujian Integrasi

Banyak kerangka kerja pengujian dan alat pengujian-kontrak (REST Assured, Karate, Postman) menggunakan JSONPath untuk menegaskan badan respons. Susun path asersi di sini, verifikasi ia memilih node yang tepat terhadap respons nyata, dan salin ke pengujian Anda — menangkap path yang salah sebelum suite menjadi merah.

Konfigurasi Transformasi Data dalam Pipeline

Kubernetes, AWS Step Functions, Azure Logic Apps, dan banyak alat ETL menerima JSONPath untuk mengalamatkan bidang dalam payload kejadian. Prototipekan path persis terhadap kejadian representatif di sini, konfirmasi ia menyelesaikan, dan letakkan ke konfigurasi pipeline Anda dengan keyakinan bahwa ia menunjuk ke tempat yang Anda maksudkan.

Reproduksi Hasil jsonpath.com secara Privat

Memiliki ekspresi dari evaluator berbasis server tetapi tidak dapat menempel data Anda ke situs pihak ketiga? Beralihlah ke mode Klasik (Goessner), muat JSON Anda, dan reproduksi hasil yang sama secara lokal — tidak ada payload yang pernah meninggalkan browser Anda, sehingga data berpemilik tetap di mesin Anda.

Migrasikan Ekspresi Lawas ke RFC 9535

Beralih ke sistem yang mengiklankan kepatuhan RFC 9535? Jalankan ekspresi lawas dalam mode Klasik, lalu beralih ke mesin RFC 9535 untuk melihat apakah ia masih diurai dan mencocokkan node yang sama. Perbandingan mesin ganda menunjukkan dengan tepat perbedaan filter, gabungan, dan fungsi yang sebaliknya akan Anda temui di produksi.

Debug Mengapa Sebuah Path Mengembalikan Node yang Salah

Sebuah path yang memilih terlalu banyak atau terlalu sedikit sulit dipikirkan dari nilai saja. Beralihlah ke tampilan Paths untuk melihat lokasi ternormalisasi setiap kecocokan — indeks larik persis, rantai anggota persis — dan irisan off-by-one atau penurunan rekursif liar menjadi jelas seketika.

Ajarkan atau Tinjau JSONPath

Buka ekspresi yang berfungsi terhadap data sampel dan telusuri selektor demi selektor, beralih antara Values dan Paths sehingga pembelajar melihat baik apa yang dipilih maupun di mana ia berada. Lembar contekan dan contoh yang dikerjakan memberikan referensi terstruktur untuk tinjauan kode atau onboarding.

Catatan Mesin & Algoritme

Mesin RFC 9535 (jsonpath-rfc9535, Tanpa Dependensi)

Mesin default mengimplementasikan tata bahasa IETF RFC 9535 secara langsung: ia mentokenisasi dan mengurai ekspresi menjadi pohon sintaks abstrak dan menafsirkannya terhadap dokumen. Tidak ada eval dan tidak ada konstruktor Function di mana pun dalam jalur, sehingga ia kebal terhadap kelas bug injeksi-eval dan berjalan di bawah Content-Security-Policy yang ketat.

Mesin Klasik (jsonpath-plus, Eval Dinonaktifkan)

Mesin Klasik (Goessner) adalah jsonpath-plus, disematkan ke rilis yang ditambal (>= 10.4.0) dan dikonstruksi dengan opsi eval disetel secara eksplisit ke false. Itu mempertahankan kompatibilitas dialek-Goessner sambil menutup vektor eksekusi kode jarak jauh yang dilacak sebagai CVE-2024-21534 dan CVE-2025-1302, yang memengaruhi jalur filter berbasis eval default pustaka.

Pembuatan Path Ternormalisasi

Setiap kecocokan dilaporkan dengan path ternormalisasi RFC 9535-nya — bentuk kanonis menggunakan notasi kurung berkutip-tunggal ($['store']['book'][0]['title']) dengan indeks larik sebagai integer telanjang. Path ternormalisasi stabil dan unik per node, sehingga ekspresi setara menghasilkan path identik, yang diandalkan tampilan Paths dan Both untuk identifikasi hasil yang tidak ambigu.

Potongan Mesin yang Dimuat Malas

Kedua mesin dimuat sebagai potongan JavaScript terpisah hanya saat pertama kali dipilih, sehingga halaman awal tetap ringan dan mesin yang tidak Anda gunakan tidak pernah diunduh. Beralih mesin mengevaluasi ulang ekspresi saat ini terhadap dokumen saat ini seketika, tanpa muat ulang halaman.

Pembacaan Berkas Lokal dan Pemformatan JSON

Tombol Unggah menggunakan API FileReader browser untuk membaca berkas .json atau .txt ke dalam masukan sepenuhnya sisi-klien — berkas tidak pernah dikirimkan. Format JSON mengurai dan menserialisasi ulang masukan dengan indentasi dua spasi, memunculkan kesalahan parse sebaris sehingga JSON yang cacat tertangkap sebelum evaluasi.

Tautan Permanen via Hash URL (Tidak Pernah Dikirimkan)

Keadaan berbagi dikodekan dalam fragmen location.hash, membawa JSON, ekspresi, mesin aktif, dan tampilan hasil. Browser tidak pernah menyertakan fragmen dalam permintaan HTTP, sehingga server go-tools.org menerima nol data saat tautan permanen dibuka; hidrasi terjadi sepenuhnya di perangkat penerima.

Praktik Terbaik JSONPath

Pilih Mesin yang Cocok dengan Target Anda

Jika sistem hilir Anda mengiklankan kepatuhan RFC 9535, tulis dan validasi terhadap mesin RFC 9535. Jika Anda mereproduksi atau memelihara ekspresi dari alat atau pustaka lebih lama, gunakan Klasik (Goessner). Validasi terhadap dialek yang salah adalah alasan paling umum mengapa path yang berfungsi di penguji gagal di produksi.

Verifikasi dengan Tampilan Paths, Bukan Hanya Values

Tampilan Values memberi tahu Anda apa yang cocok; tampilan Paths memberi tahu Anda di mana. Saat kueri mengembalikan nilai yang terlihat benar, ia mungkin masih memilihnya dari lokasi yang salah — penurunan rekursif liar atau wildcard yang terlalu luas. Periksa path ternormalisasi untuk mengonfirmasi ekspresi mengenai persis node yang Anda maksudkan.

Perhatikan Akhir Eksklusif dari Irisan

[0:2] memilih indeks 0 dan 1, bukan 0 hingga 2 — batas akhir bersifat eksklusif, persis seperti Python dan JavaScript. Kesalahan irisan off-by-one adalah bug JSONPath paling sering. Gunakan tampilan Paths untuk membaca indeks persis setiap elemen yang dipilih dan konfirmasi batas sebelum Anda mengirim.

Utamakan Path Eksplisit Dibanding Penurunan Rekursif Bila Bisa

$..price nyaman tetapi mencocokkan setiap price di mana pun dalam dokumen, termasuk yang tidak Anda maksudkan. Saat Anda mengetahui strukturnya, eja path ($.store.book[*].price) agar kueri tetap presisi dan dapat diprediksi seiring data bertumbuh. Cadangkan .. untuk bentuk yang benar-benar tidak beraturan atau tidak dikenal.

Jaga Spasi dan Tanda Kutip Konsisten dalam Filter

RFC 9535 mengikuti tata bahasanya secara persis untuk ekspresi filter, sementara dialek klasik lebih longgar. Tulis filter dengan bersih — kutip literal string dengan tanda kutip tunggal ('fiction'), jaga operator diberi spasi, dan hindari mengandalkan parsing yang longgar — sehingga ekspresi yang sama dievaluasi dengan cara yang sama terlepas dari mesin atau pustaka mana yang akhirnya menjalankannya.

Pertanyaan yang Sering Diajukan