Baca JSON dengan PowerShell, bedakan kesalahan penulisan dan tipe nilai, lalu uji tujuh contoh lokal sebelum pengaturan dipakai pada aplikasi website.
Sebuah berkas JSON dapat dipakai untuk menyimpan pengaturan tampilan, daftar menu, atau data pendukung website. Ketika pengelola mengganti isinya, ada dua pertanyaan berbeda yang perlu dijawab: apakah teks dapat diproses pembaca JSON dan apakah nilai di dalamnya cocok dengan kebutuhan aplikasi. Memisahkan kedua pertanyaan tersebut membantu percakapan antara editor dan pengembang. Pesan bahwa berkas berhasil dibaca belum menjelaskan apakah judul tersedia, jenis nilai benar, atau batas tampilan masuk akal untuk halaman yang dikerjakan.
Tutorial ini memakai berkas pengaturan buatan untuk latihan lokal dengan PowerShell. Tidak ada pengaturan aplikasi nyata yang dibuka atau diunggah. Aturan contohnya sengaja kecil: judul berupa teks tidak kosong, aktif berupa boolean, batasTampil berupa bilangan bulat antara satu dan dua puluh, serta menu berupa array tidak kosong. Batas tersebut adalah keputusan latihan, bukan ketentuan JSON atau layanan hosting. Pemeriksaan ini juga bukan validator JSON Schema, pemeriksa keamanan, atau bukti bahwa website akan bekerja setelah berkas dipasang.

Siapkan editor teks biasa, PowerShell, serta folder latihan yang terpisah dari proyek produksi. Contoh telah diuji pada Windows PowerShell 5.1.19041.6456. Periksa versi lingkungan Anda dengan $PSVersionTable.PSVersion sebelum mencatat hasil. Tutorial memakai parameter dasar yang tersedia pada lingkungan uji tersebut, tanpa modul tambahan. Bila aturan komputer membatasi pelaksanaan skrip, ikuti prosedur yang berlaku bersama pengelola komputer. Anda tidak perlu mengubah kebijakan eksekusi hanya untuk mempelajari contoh atau membaca kode pemeriksaan yang disediakan.
Gunakan data contoh, bukan salinan berkas yang berisi akses layanan atau informasi pelanggan. Buat catatan berisi nama berkas, perubahan yang sengaja dibuat, hasil yang diharapkan, dan hasil aktual. Catatan ini akan dipakai ketika membandingkan kesalahan penulisan dengan kesalahan tipe nilai. Simpan satu salinan contoh valid sebagai pembanding agar Anda dapat mengulang latihan tanpa menebak isi awalnya. Kebiasaan bekerja pada salinan juga membantu mencegah perbaikan contoh tercampur dengan perubahan yang nantinya akan diterapkan pada website sebenarnya.

Simpan berkas bernama tampilan-valid.json dengan isi berikut pada satu baris: {"judul":"Layanan Usaha","aktif":true,"batasTampil":6,"menu":["Profil","Kontak"]}. Pastikan nama akhirnya .json dan editor menyimpan berkas sebagai UTF-8. Pada contoh ini, judul adalah teks, aktif adalah boolean, batasTampil adalah angka, dan menu adalah kumpulan dua teks. Tanda kutip pada nilai teks mempunyai fungsi yang berbeda dari penulisan true tanpa tanda kutip. Pertahankan perbedaan tersebut saat menyalin contoh awal.
RFC 8259 mendefinisikan jenis nilai JSON, termasuk string, number, boolean, object, array, dan null. Nama anggota object ditulis sebagai string, sedangkan literal true, false, dan null memakai huruf kecil. Gunakan ketentuan ini untuk membaca contoh, tanpa menganggap setiap jenis nilai cocok untuk semua pengaturan aplikasi. Misalnya, array adalah jenis nilai yang sah, tetapi aplikasi tetap perlu menentukan apakah setiap anggotanya harus berupa teks. Keputusan tentang isi dan kebutuhan tersebut berada di atas aturan penulisan format JSON itu sendiri.
Jalankan $data = Get-Content -LiteralPath '.\tampilan-valid.json' -Raw -Encoding UTF8 | ConvertFrom-Json -ErrorAction Stop dari folder latihan. Dokumentasi Microsoft menjelaskan bahwa -Raw mengembalikan isi berkas sebagai satu string, lalu ConvertFrom-Json mengubah teks JSON menjadi object PowerShell. Penggunaan -LiteralPath membantu menunjuk nama berkas secara langsung. Parameter UTF8 menyatakan encoding yang digunakan untuk membaca contoh. Jika proses berhenti dengan kesalahan, periksa nama berkas, lokasi terminal, encoding, serta isi teks sebelum melanjutkan ke pemeriksaan nilai.
Lihat $data.judul, $data.aktif, $data.batasTampil, dan $data.menu secara bergantian. Untuk contoh valid, Anda mengharapkan judul Layanan Usaha, aktif bernilai benar, batas tampilan enam, dan dua anggota menu. Catat hasil pembacaan ini sebagai tahap tersendiri. Jangan langsung menganggap semua nilai cocok hanya karena terminal menampilkannya. Tampilan true dan teks yang berisi kata true dapat terlihat mirip bagi pembaca, sehingga pemeriksaan tipe pada langkah berikut menjadi bagian penting dari latihan yang dapat diulang.
Simpan kode latihan di bagian ini sebagai periksa-tampilan.ps1, lalu jalankan .\periksa-tampilan.ps1 -Path '.\tampilan-valid.json'. Skrip membaca berkas yang ditunjuk dan menghasilkan tiga kolom: Terbaca, SesuaiContoh, dan Catatan. Untuk contoh awal, hasil yang diharapkan adalah Terbaca bernilai True dan SesuaiContoh bernilai True. Kolom Catatan tidak memuat masalah. Kode hanya membaca berkas masukan dan menyusun hasil pemeriksaan; kode tidak mengubah berkas pengaturan atau mengirimkannya ke website maupun layanan lain.
Kode latihan (simpan sebagai periksa-tampilan.ps1): param([Parameter(Mandatory=$true)][string]$Path) try { $data = Get-Content -LiteralPath $Path -Raw -Encoding UTF8 -ErrorAction Stop | ConvertFrom-Json -ErrorAction Stop } catch { [PSCustomObject]@{ Terbaca=$false; SesuaiContoh=$false; Catatan='Berkas tidak dapat dibaca atau JSON gagal diproses' } return } $masalah = @() if ($data.judul -isnot [string] -or [string]::IsNullOrWhiteSpace($data.judul)) { $masalah += 'judul harus teks tidak kosong' } if ($data.aktif -isnot [bool]) { $masalah += 'aktif harus boolean' } if (($data.batasTampil -isnot [int] -and $data.batasTampil -isnot [long]) -or $data.batasTampil -lt 1 -or $data.batasTampil -gt 20) { $masalah += 'batasTampil harus integer 1 sampai 20' } if ($data.menu -isnot [array] -or $data.menu.Count -eq 0) { $masalah += 'menu harus array tidak kosong' } [PSCustomObject]@{ Terbaca=$true; SesuaiContoh=($masalah.Count -eq 0); Catatan=($masalah -join '; ') }
Perhatikan aturan yang benar-benar tertulis pada skrip. Pemeriksaan menu hanya memastikan nilainya array dan tidak kosong, belum memastikan jenis setiap anggota. Pemeriksaan judul menolak teks kosong, sedangkan batasTampil hanya menerima integer dalam rentang latihan. Nama kolom SesuaiContoh sengaja membatasi kesimpulan hasil. Jika proyek Anda membutuhkan aturan berbeda, tuliskan kebutuhan itu lebih dahulu bersama pengembang. Jangan menggunakan skrip kecil ini sebagai alasan untuk mengabaikan struktur pengaturan yang sesungguhnya dibutuhkan aplikasi atau pemeriksaan lain yang belum dibuat.
Buat salinan bernama tampilan-rusak.json, lalu isi dengan potongan yang belum ditutup: {"judul":"Layanan Usaha","aktif":true. Jalankan skrip pemeriksaan terhadap salinan tersebut. Dalam pengujian lokal contoh, hasil Terbaca adalah False karena teks tidak dapat diproses. Keterangan skrip juga mencakup kemungkinan berkas tidak dapat dibaca, sehingga bila menemui hasil serupa pada latihan lain, pastikan dahulu jalurnya benar. Tanda gagal tidak boleh langsung ditafsirkan sebagai kesalahan isi tanpa meninjau apakah berkas yang dimaksud berhasil ditemukan.
Pulihkan salinan tersebut dengan menyalin kembali seluruh isi contoh valid, simpan, kemudian periksa ulang. Hasilnya seharusnya kembali sesuai contoh. Latihan ini mengajarkan urutan kerja yang jelas: mulai dari pembanding yang diketahui, buat satu kerusakan, lalu pulihkan dan ulangi pemeriksaan. Hindari menghapus beberapa tanda sekaligus ketika baru belajar, sebab pesan kesalahan akan lebih sulit dihubungkan dengan penyebab tertentu. Simpan catatan perubahan agar orang lain dapat memahami mengapa hasil sebelum dan sesudah perbaikan berbeda.
Pada salinan lain, ganti nilai aktif dari true menjadi "true" sambil mempertahankan anggota lain. Ini tetap berbentuk teks JSON yang dapat diproses pada contoh, tetapi nilainya kini string. Hasil yang diharapkan adalah Terbaca True dan SesuaiContoh False, disertai catatan tentang boolean. Coba pula mengganti batasTampil menjadi nol, menghapus judul, atau mengubah menu menjadi satu string. Jalankan setiap variasi secara terpisah agar perubahan hasil dapat dihubungkan dengan aturan yang sedang diuji.
Tambahkan kasus menu bernilai [1,2]. Pada skrip latihan, kasus ini diterima karena array tidak kosong dan aturan lain terpenuhi. Hasil tersebut sengaja dipakai untuk memperlihatkan batas pemeriksaan: skrip belum memeriksa jenis anggota menu. Jika proyek memerlukan setiap anggota berupa teks, buat pemeriksaan tambahan bersama pengembang dan sediakan kasus yang membuktikannya. Contoh yang diterima oleh aturan terbatas dapat tetap tidak cocok untuk aplikasi nyata. Memahami batas ini lebih berguna daripada menambahkan label “valid seluruhnya” pada setiap hasil yang lolos.
Ulangi tujuh kondisi latihan: contoh valid, teks tidak ditutup, boolean yang berubah menjadi string, batas nol, judul hilang, menu berupa string, dan menu berupa array angka. Pada persiapan artikel, ketujuh hasil sesuai dengan sasaran masing-masing. Pemeriksaan hanya menyentuh berkas buatan pada folder latihan. Tidak ada hasil pemasangan pengaturan website yang diklaim. Simpan versi skrip dan contoh yang digunakan supaya pemeriksaan berikutnya dapat mengulang kondisi yang sama, bukan membandingkan dua berkas yang sudah berubah tanpa catatan.
Tinjau pula nama anggota yang berulang sebelum memakai JSON pada proyek. RFC 8259 menganjurkan nama anggota object unik untuk interoperabilitas, dan dokumentasi Microsoft menjelaskan bahwa ConvertFrom-Json dapat mempertahankan nilai terakhir untuk nama yang sama. Skrip latihan tidak mengaudit duplikasi nama. Jika proses proyek mensyaratkan penolakan duplikasi atau validasi skema lengkap, gunakan alat dan pengujian yang memang menangani kebutuhan itu. Catat kekurangan pemeriksaan secara terbuka agar hasil lokal tidak diteruskan sebagai persetujuan yang lebih luas daripada buktinya.
Kesalahan umum meliputi lupa menyimpan perubahan, menjalankan perintah dari folder lain, menganggap semua nilai yang terlihat benar mempunyai tipe yang sama, dan memakai keberhasilan parsing sebagai persetujuan aplikasi. Kebiasaan menambahkan komentar juga perlu ditinjau: Microsoft mencatat perbedaan dukungan komentar antara Windows PowerShell 5.1 dan versi yang lebih baru. Untuk latihan ini, pertahankan JSON tanpa komentar. Catat versi lingkungan saat membandingkan hasil, karena penerimaan oleh satu pembaca tidak berarti semua perangkat lunak akan memperlakukan masukan yang sama persis serupa.
Setelah aturan lokal cocok, lanjutkan pengujian fitur pada lingkungan uji aplikasi sebelum mempertimbangkan pemasangan berkas. Untuk perencanaan penempatan website, pengantar layanan tersedia di https://www.jagoweb.com/ dan halaman hosting cPanel di https://www.jagoweb.com/hosting-cpanel. Cocokkan kebutuhan aplikasi dengan layanan yang dibahas, tanpa menganggap tutorial ini sebagai bukti suatu paket memiliki pengaturan tertentu. Hasil yang berguna adalah catatan yang jelas tentang berkas, aturan, dan batas pemeriksaannya, sehingga editor serta pengembang dapat menentukan pengujian lanjutan berdasarkan pekerjaan yang benar-benar akan dilakukan.