Penjelasan Pengujian Kontrak API: Tangkap Perubahan yang Dapat Mengganggu Sebelum Dikirim
Saat satu tim mengubah API, aplikasi tim lain dapat rusak tanpa ada yang menyadarinya hingga produksi. Pengujian kontrak memeriksa apakah kedua belah pihak masih setuju, tanpa menjalankan keseluruhan sistem. Kami menguji lima perubahan API yang realistis terhadap kontrak untuk menunjukkan perubahan mana yang merugikan konsumen.
- kontrak adalah bentuk permintaan dan tanggapan yang disepakati antara penyedia API dan konsumennya.
- Tes kontrak memeriksa masing-masing pihak terhadap perjanjian tersebut secara terpisah, sehingga Anda tidak perlu menjalankan semua layanan.
- Dalam pemeriksaan kami, penambahan bidang berhasil, saat mengganti nama bidang, mengubah jenis, atau menambahkan nilai enum gagal.
- Kontrak yang didorong oleh konsumen, seringkali dengan Pakta, hanya menguji apa yang sebenarnya digunakan konsumen.
Tim pesanan mengganti nama total menjadi amount karena bacaannya lebih baik. Tes mereka sendiri lulus, dan mereka menerapkannya. Sepuluh menit kemudian, aplikasi seluler menunjukkan setiap pesanan tidak dikenakan biaya, dan layanan faktur terhenti. Setiap tim menguji kodenya sendiri, namun tidak ada yang menguji kesepakatan di antara mereka. Kesenjangan itulah yang diisi oleh pengujian kontrak.
Kami membuat kontrak kecil sebagai Skema JSON dan memeriksa lima respons penyedia yang realistis terhadap kontrak tersebut dengan pustaka Python jsonschema (versi 4.26). Hasil di bawah berasal dari proses tersebut. Peralatan Pakta dan OpenAPI dijelaskan dari dokumentasinya; kami tidak menjalankannya untuk artikel ini.
Masalah dengan layanan pengujian secara terpisah
Dalam sistem yang terdiri dari banyak layanan, setiap tim menulis pengujian unit dan pengujian API untuk layanannya sendiri. Pengujian tersebut menggunakan gagasan tim sendiri tentang apa yang dikirim dan diharapkan oleh layanan lain, sering kali sebagai tiruan. Ketika penyedia berubah, tiruan konsumen tetap kembali ke bentuk lama, sehingga pengujian konsumen tetap berjalan. Ketidakcocokan hanya ditemukan ketika kedua versi bertemu di lingkungan bersama atau dalam produksi. Pengujian menyeluruh end-to-end dapat menangkapnya, namun lambat, rapuh, dan memerlukan semuanya dikerahkan secara bersamaan.
Apa itu pengujian kontrak?
Pengujian kontrak memeriksa bahwa dua pihak, konsumen yang memanggil API dan penyedia yang melayaninya, menyetujui cara mereka berkomunikasi: titik akhir, metode, header, badan permintaan, bidang respons, jenis, dan kode status. Perjanjian tersebut ditulis sebagai kontrak yang dapat dibaca mesin. Masing-masing pihak kemudian diuji terhadap kontraknya sendiri: konsumen terhadap tiruan yang dibuat dari kontrak, dan penyedia dengan memutar ulang permintaan kontrak terhadap layanan sebenarnya.
Dibandingkan dengan jenis tes lainnya
| Jenis tes | Cek | Perlu layanan lain berjalan? |
|---|---|---|
| Tes satuan | Logika batin | Tidak |
| API/uji fungsional | Perilaku satu layanan | Biasanya tidak |
| Tes kontrak | Perjanjian antara dua layanan | Tidak |
| Tes integrasi | Layanan nyata bekerja sama | Ya |
| Tes ujung ke ujung | Seluruh perjalanan pengguna | Ya, semuanya |
Pengujian kontrak berada di antara pengujian API dan pengujian integrasi dalam piramida pengujian. Mereka hampir secepat pengujian unit tetapi menangkap masalah yang sebelumnya memerlukan lingkungan integrasi.
Pemeriksaan kontrak yang kami jalankan
Berikut adalah kontrak sederhana untuk respons pesanan, yang ditulis sebagai Skema JSON:
contract = {
"type": "object",
"required": ["id", "status", "total"],
"properties": {
"id": {"type": "integer"},
"status": {"enum": ["paid", "pending", "refunded"]},
"total": {"type": "number", "minimum": 0}
}
}
Kami memvalidasi lima versi respons penyedia:
v1 provider PASS
v1 + new field PASS
renamed total->amount FAIL: 'total' is a required property
id as string FAIL: '101' is not of type 'integer'
new status value FAIL: 'on_hold' is not one of ['paid', 'pending', 'refunded']
Menambahkan kolom currency aman karena konsumen mengabaikan kolom yang tidak mereka ketahui. Mengganti nama total, mengirimkan ID sebagai teks, dan memperkenalkan nilai status baru semuanya melanggar kontrak. Masing-masing akan lulus tes penyedia sendiri.
Perubahan yang merusak vs perubahan yang aman
| Perubahan | Biasanya pecah? |
|---|---|
| Tambahkan bidang respons opsional | Tidak |
| Tambahkan titik akhir baru | Tidak |
| Hapus atau ganti nama bidang respons | Ya |
| Mengubah jenis atau format bidang | Ya |
| Buat bidang permintaan opsional wajib diisi | Ya |
| Tambahkan nilai enum baru dalam respons | Seringkali, jika konsumen menangani nilai dengan ketat |
| Ubah kode status atau format kesalahan | Ya |
| Perketat validasi pada input | Seringkali |
Kasus enumnya halus. Menambahkan on_hold tampaknya tidak berbahaya bagi penyedia, namun konsumen dengan pernyataan switch mengenai status yang diketahui mungkin mogok atau tidak menunjukkan apa pun. Konsumen yang baik hati menangani nilai-nilai yang tidak diketahui dengan baik, dan kontrak membuat ekspektasi tersebut menjadi eksplisit. Untuk strategi pembuatan versi ketika perubahan yang dapat menyebabkan gangguan tidak dapat dihindari, lihat pembuatan versi semantik dan praktik terbaik REST API kami.
Kontrak yang didorong oleh konsumen
Dalam pengujian kontrak berbasis konsumen, setiap konsumen menuliskan dengan tepat apa yang dibutuhkannya dari penyedia: permintaan yang dibuat dan kolom yang dibacanya. Penyedia harus memenuhi kontrak setiap konsumen. Hal ini memiliki keuntungan besar: penyedia dapat dengan bebas mengubah atau menghapus apa pun yang tidak digunakan oleh konsumen, dan penyedia mengetahui dengan pasti konsumen mana yang akan rusak jika mengubah sesuatu yang digunakan.
Demo kami memeriksa satu skema, yang lebih mirip dengan gaya berbasis penyedia. Kontrak nyata yang digerakkan oleh konsumen biasanya hanya mencantumkan bidang yang benar-benar dibaca konsumen, sehingga bidang yang tidak digunakan oleh siapa pun dapat dihapus tanpa kegagalan apa pun.
Kiat: Kontrak harus menjelaskan apa yang dibutuhkan konsumen, bukan semua yang dikembalikan oleh penyedia. Kontrak yang menyematkan setiap bidang dan nilai pastinya menjadi salinan rapuh dari pengujian penyedia, gagal dalam melakukan perubahan yang tidak berbahaya dan mengikis kepercayaan.
Bagaimana Pakta bekerja
Pakta adalah alat kontrak berbasis konsumen yang paling banyak digunakan, dengan perpustakaan untuk banyak bahasa. Alurnya, dari dokumentasinya:
- Uji konsumen: pengujian unit konsumen memanggil server tiruan Pakta, mendeklarasikan setiap permintaan yang diharapkan dan respons minimal yang diperlukan.
- File pakta: ekspektasi tersebut disimpan sebagai kontrak JSON, “pakta”.
- Bagikan: pakta dipublikasikan ke Pact Broker atau PactFlow.
- Verifikasi penyedia: CI penyedia mengambil semua perjanjian, memutar ulang setiap permintaan terhadap penyedia sebenarnya, dan memeriksa responsnya.
- Dapatkah saya menerapkan? Sebelum menerapkan kedua sisi, pemeriksaan mengonfirmasi bahwa versi yang akan dijalankan bersama telah memverifikasi kontrak.
Status penyedia, seperti “pesanan 101 ada”, memungkinkan penyedia menyiapkan data pengujian untuk setiap interaksi. Di sinilah sebagian besar tim menghabiskan upaya mereka ketika mengadopsi Pakta.
Kontrak berbasis penyedia dengan OpenAPI
Banyak tim memulai dari arah lain: penyedia menerbitkan spesifikasi OpenAPI, dan pengujian memeriksa apakah API sebenarnya cocok dengan spesifikasi tersebut, dan bahwa konsumen hanya menggunakan apa yang dijelaskannya. Alat dapat memvalidasi respons langsung terhadap spesifikasi, menghasilkan pengujian darinya, atau membandingkan dua versi spesifikasi dan perubahan yang dapat menyebabkan kerusakan tanda. Ini berfungsi dengan baik untuk API publik dengan banyak konsumen yang tidak dikenal, sehingga pengumpulan kontrak konsumen tidak mungkin dilakukan. Keuntungannya adalah ia memeriksa tata bahasa pesan, bukan bagian mana yang benar-benar diandalkan oleh konsumen.
Tes kontrak di CI
- Saluran konsumen: menjalankan pengujian kontrak konsumen dan memublikasikan kontrak pada setiap perubahan.
- Pipa penyedia: memverifikasi semua kontrak konsumen pada setiap perubahan; gagal dalam pembangunan jika ada jeda.
- Sebelum penerapan: periksa kompatibilitas antara versi persisnya di setiap lingkungan.
- Webhook: ketika konsumen memublikasikan kontrak yang diubah, segera picu verifikasi penyedia.
Memasukkannya ke dalam pipa CI/CD menghasilkan “apakah kita merusak seseorang?” dari pertemuan menjadi status pembangunan.
Jebakan
- Penentuan yang berlebihan: menegaskan nilai yang tepat, bukan jenis dan bidang yang wajib diisi, membuat kontrak menjadi rapuh.
- Memperlakukan kontrak sebagai uji fungsional: kontrak memeriksa bentuk dan perjanjian, bukan kebenaran bisnis. Pertahankan tes fungsional juga.
- Melewati status penyedia: tanpa data penyiapan yang realistis, verifikasi lolos karena alasan yang salah.
- Tidak ada kepemilikan: seseorang harus memiliki broker tersebut dan merespons ketika verifikasi gagal.
- Melupakan pesan asinkron: peristiwa di antrean juga merupakan kontrak, dan alat seperti Pakta mendukung kontrak pesan.
Kapan menggunakan pengujian kontrak
Pengujian kontrak membuahkan hasil ketika beberapa tim memiliki layanan yang saling menelepon, penerapan bersifat independen, dan lingkungan integrasi lambat atau tidak dapat diandalkan. Untuk satu tim dengan satu API dan satu front end yang diterapkan bersama, pengujian API yang baik mungkin sudah cukup. Panduan pengujian API kami mencakup titik awal tersebut.
Memulai tanpa membuat lautan mendidih
- Pilih satu pasangan: konsumen dan penyedia yang integrasinya paling sering terputus, atau paling penting.
- Tulis ekspektasi konsumen untuk dua atau tiga interaksi utama, dengan hanya menyatakan bidang yang dibacanya.
- Verifikasi penyedia terhadap mereka secara lokal, perbaiki status penyedia hingga lolos karena alasan yang benar.
- Tambahkan kedua belah pihak ke CI, sehingga tim mana pun akan mengetahui dalam hitungan menit jika terjadi pelanggaran perjanjian.
- Tinjau setelah beberapa minggu: apakah ada yang tertangkap, dan apakah ada yang rusak sehingga terlewat? Kemudian lanjutkan ke pasangan berikutnya.
Memulai dari hal kecil membuat upaya tetap terlihat dan membangun kepercayaan. Tim yang mencoba untuk mengontrak setiap layanan sekaligus sering kali berhenti menggunakan alat dan menguji data sebelum melihat manfaat apa pun.
Penutup
Pengujian kontrak menangkap perubahan yang dapat menyebabkan gangguan yang tidak dapat dilihat oleh pengujian masing-masing tim: bidang yang diganti namanya, tipe yang diubah, dan nilai enum baru. Mulailah dengan satu pasangan konsumen-penyedia yang penting, pertahankan kontrak tetap fokus pada apa yang sebenarnya digunakan konsumen, verifikasi penyedia di CI, dan tambahkan pemeriksaan penerapan. Dalam pengujian sederhana kami, tiga dari lima perubahan yang masuk akal akan berdampak buruk pada konsumen, semuanya tidak terlihat oleh rangkaian penyedia layanan itu sendiri.
Pertanyaan yang sering diajukan
Apa itu pengujian kontrak API?
Menguji apakah penyedia API dan konsumennya menyetujui format permintaan dan respons, dengan memeriksa masing-masing pihak secara terpisah terhadap kontrak bersama alih-alih menjalankan semua layanan secara bersamaan.
Apa yang dimaksud dengan pengujian kontrak berbasis konsumen?
Suatu pendekatan di mana setiap konsumen mendefinisikan permintaan yang dibuatnya dan bidang yang dibutuhkannya. Penyedia diverifikasi terhadap semua kontrak konsumen, sehingga mengetahui perubahan mana yang akan merugikan seseorang.
Apa itu Pakta?
Pakta adalah alat sumber terbuka yang populer untuk pengujian kontrak berbasis konsumen. Tes konsumen menghasilkan file kontrak, yang kemudian diverifikasi oleh penyedia terhadap implementasi sebenarnya.
Apakah menambahkan bidang merupakan perubahan besar?
Menambahkan kolom respons opsional biasanya aman; dalam pengujian kami itu lulus. Mengganti nama, menghapus, atau mengubah jenis bidang akan merugikan konsumen.
Apakah pengujian kontrak menggantikan pengujian end-to-end?
Ini menggantikan banyak dari mereka, terutama yang digunakan hanya untuk memeriksa apakah layanan dapat berkomunikasi. Lakukan beberapa pengujian menyeluruh untuk perjalanan pengguna yang penting.
Teruslah belajar
Butuh bantuan dengan pengujian, WordPress atau SEO?
Kami membantu tim mengirimkan perangkat lunak yang lebih baik dan mengembangkan situs mereka. Beritahu kami apa yang sedang Anda kerjakan dan kami akan menyarankan langkah selanjutnya yang jelas.
Panduan lebih lanjut tentang pengujian, AI & pengembangan modern
Menikmati artikel ini? Pilih topik dan langsung masuk ke tutorial terbaru kami.
Penjelasan Strategi Chunking RAG: Tetap, Tumpang Tindih, Kalimat, Rekursif dan Judul, Terukur
Strategi pengelompokan RAG dibandingkan pada satu dokumen dengan tiktoken 0.14: ukuran tetap, tumpang tindih, pengepakan kalimat, pemisahan rekursif…
Baca artikel →Pengembangan perangkat lunakPenjelasan Idempotensi API: Kunci Idempotensi dan Percobaan Ulang Aman, Diuji
Idempotensi API dijelaskan dengan server dan klien Python yang kami jalankan: respons yang hilang menyebabkan tagihan ganda tanpa kunci dan satu tag…
Baca artikel →DevOpsPenjelasan Git Stash: Simpan, Terapkan, Pop dan File Tidak Terlacak, Diuji
Git stash dijelaskan dengan perintah yang kami jalankan di Git 2.56: push dengan pesan, file yang tidak terlacak, daftar dan tampilkan, terapkan vs …
Baca artikel →Pengujian perangkat lunakPenjelasan Pengujian Berpasangan: Bagaimana Semua Pasangan Memotong 216 Tes menjadi 13, Diuji
Pengujian berpasangan dijelaskan dengan generator yang kami jalankan di Python 3.13: checkout dengan 216 kombinasi yang tercakup dalam 13 pengujian,…
Baca artikel →Otomatisasi pengujianPenjelasan Tes Ganda: Dummy, Stub, Spy, Mock dan Fake, dengan Kode Python yang Diuji
Tes ganda dijelaskan dengan satu contoh Python yang dijalankan di pytest 9.2: dummy, stub, spy, mock dan fake, kapan menggunakan masing-masing, peme…
Baca artikel →Basis data & SQLPenjelasan SQL COALESCE: Default, NULLIF, IFNULL vs ISNULL dan Traps, Diuji
SQL COALESCE dijelaskan dengan kueri yang kami jalankan di SQLite 3.50: nilai bukan nol pertama, string kosong, NULL dalam matematika, NULLIF untuk …
Baca artikel →Basis data & SQLSQL Self Join Dijelaskan: Karyawan-Manajer, Perbandingan Pasangan dan Baris, Diuji
Gabung mandiri SQL dijelaskan dengan kueri yang kami jalankan di SQLite 3.50: karyawan dan manajer, penghasilan lebih dari manajer, pasangan unik, p…
Baca artikel →Pengembangan perangkat lunakPenjelasan Operator Penyebaran JavaScript: Penyebaran vs Istirahat, Salinan dan Gotcha, Diuji
Operator penyebaran JavaScript menjelaskan dengan kode yang kami jalankan di Node 24: array, objek, salinan dangkal, parameter istirahat, batas Math…
Baca artikel →Pengembangan perangkat lunakPenjelasan Modul Koleksi Python: Counter, defaultdict, deque dan Lainnya, Diuji
Koleksi Python dijelaskan dengan kode yang kami jalankan di Python 3.13: Counter, defaultdict, deque, nametuple, OrderedDict dan ChainMap, ditambah …
Baca artikel →Kecerdasan buatanJendela Konteks LLM Dijelaskan: Token, Batasan, dan Cara Menyesuaikannya Lebih Banyak, Diukur
Jendela konteks LLM dijelaskan dengan jumlah token yang kami ukur menggunakan tiktoken: kata vs token untuk prosa, kode dan bahasa Hindi, anggaran i…
Baca artikel →Pengembangan perangkat lunakPenjelasan Webhook: Cara Kerjanya dan Cara Menerimanya dengan Aman
Webhook menjelaskan dengan penerima dan pengirim yang kami jalankan dengan Python: push vs polling, tanda tangan HMAC-SHA256, menolak permintaan yan…
Baca artikel →DevOpsPenjelasan Git Cherry-Pick: Salin Komit yang Anda Butuhkan, Aman, Teruji
Git cherry-pick dijelaskan dengan perintah yang kami jalankan di Git 2.56: menyalin perbaikan terbaru ke cabang rilis, hash baru dan id patch, -x, -…
Baca artikel →Otomatisasi pengujianPenjelasan Pengujian Snapshot: Cara Kerja, Kapan Membantu, dan Kapan Menyakitkan
Pengujian snapshot dijelaskan dengan demo pytest dan manis yang kami jalankan: membuat snapshot, membaca perbedaan setelah perubahan kode, menutupi …
Baca artikel →Pengujian perangkat lunakPenjelasan Pengujian Mutasi: Mengapa Cakupan 100% Masih Melewatkan Bug Kami
Pengujian mutasi dijelaskan dengan alat mutasi kecil yang kami buat dan jalankan: 14 mutan, rangkaian pengujian dengan cakupan garis 100% yang mempe…
Baca artikel →Kecerdasan buatanPenjelasan Injeksi Cepat: Bagaimana Aplikasi AI Ditipu dan Cara Mempertahankannya
Penjelasan injeksi cepat untuk pembuat: serangan langsung dan tidak langsung, mengapa filter kata kunci gagal (pengujian kami memblokir 1 dari 4), d…
Baca artikel →DevOpsPenjelasan Catatan DNS: A, AAAA, CNAME, MX, TXT dan TTL Dengan Pencarian Nyata
Catatan DNS dijelaskan dengan pencarian yang kami jalankan: cara kerja resolusi, A dan AAAA, aturan CNAME, MX dan null MX, TXT untuk SPF dan verifik…
Baca artikel →DevOpsPenjelasan Bendera Fitur: Rilis Aman, Peluncuran Bertahap, dan Kebersihan Bendera
Tanda fitur dijelaskan dengan simulasi peluncuran yang kami jalankan: jenis tanda, persentase peluncuran dengan hashing stabil, tombol pemutus, daft…
Baca artikel →Otomatisasi pengujianUji Pembuatan Data Dengan Python Faker: Data yang Realistis, Dapat Diulang, dan Aman
Uji pembuatan data dengan Python Faker, jalankan dan ukur: penyemaian data berulang, lokal, nilai unik, catatan berbentuk domain, kasus tepi yang te…
Baca artikel →Pengujian perangkat lunakPenjelasan Pengujian Shift-Kiri: Temukan Bug Lebih Awal Tanpa Memperlambat Tim
Pengujian shift-kiri menjelaskan: apa artinya, mengapa cacat awal lebih murah, praktik mulai dari tinjauan persyaratan hingga pemeriksaan CI, peruba…
Baca artikel →Basis data & SQLPenjelasan Fungsi String SQL: TRIM, SUBSTR, REPLACE, CONCAT dan Pembersihan Data
Fungsi string SQL dijelaskan dengan kueri yang kami jalankan: penggabungan dan NULL, TRIM, UPPER dan LOWER, SUBSTR dan INSTR, REPLACE, padding, panj…
Baca artikel →Basis data & SQLPenjelasan Pemicu SQL: SEBELUM dan SETELAH Pemicu, Log Audit, dan Kesalahan
Pemicu SQL dijelaskan dengan pemicu yang kami jalankan: SEBELUM vs SETELAH, LAMA dan BARU, log audit, validasi, pembaruan stok, kondisi KAPAN, penge…
Baca artikel →Pengembangan perangkat lunakPenjelasan Modul Python JSON: dumps, load, Tipe Kustom, dan Kesalahan Umum
Modul Python JSON dijelaskan dengan kode yang kami jalankan: dumps dan load, file, konversi tipe, tanggal dan desimal, encoder khusus, object_hook, …
Baca artikel →Pengembangan perangkat lunakModul ES vs CommonJS: Cara Kerja Impor JavaScript di Node.js, Diuji
Modul ES vs CommonJS dijelaskan dengan kode yang kami jalankan di Node.js: sintaksis impor dan ekspor, persyaratan, pengikatan langsung, caching, pe…
Baca artikel →Pengembangan perangkat lunakPenjelasan Regex Python: Pola, Grup, Pandangan ke Depan, dan Kesalahan, Diuji
Regex Python dijelaskan dengan pola yang kami jalankan: pencarian vs kecocokan, temukan semua, grup dan grup bernama, serakah vs malas, sub, lihat k…
Baca artikel →Kecerdasan buatanPenjelasan Keluaran Terstruktur LLM: Mendapatkan JSON yang Andal dari Model AI
Output terstruktur LLM dijelaskan dengan validasi yang kami jalankan di Pydantic: mode dan skema JSON, decoding terbatas, cara output model terputus…
Baca artikel →DevOpsPenjelasan Kunci SSH: Cara Kerjanya, ssh-keygen, Ed25519 dan Kebiasaan Aman
Kunci SSH dijelaskan dengan kunci yang kami buat: kunci publik vs pribadi, ssh-keygen, Ed25519 vs RSA, sidik jari, frasa sandi, ssh-agent, Authorize…
Baca artikel →DevOpsPenjelasan Caching HTTP: Kontrol Cache, Respons ETag dan 304, Dengan Tes Langsung
Caching HTTP dijelaskan dengan server kecil yang kami jalankan: arahan Kontrol-Cache, max-age, no-cache vs no-store, validasi ulang ETag dan respons…
Baca artikel →Otomatisasi pengujianPenjelasan Pengujian Kontrak API: Tangkap Perubahan yang Dapat Mengganggu Sebelum Dikirim
Pengujian kontrak API dijelaskan dengan pemeriksaan skema yang kami jalankan: apa itu kontrak, kontrak yang digerakkan oleh konsumen, Pakta, OpenAPI…
Baca artikel →Pengujian perangkat lunakPenjelasan Pengujian Berbasis Risiko: Nilai Risiko, Buat Matriks, dan Uji Hal yang Penting
Pengujian berbasis risiko menjelaskan langkah demi langkah: mengidentifikasi risiko, menilai kemungkinan dan dampak, membangun matriks risiko, memet…
Baca artikel →Basis data & SQLPenjelasan Kendala SQL: BUKAN NULL, UNIK, PERIKSA dan KUNCI ASING, Diuji
Batasan SQL dijelaskan dengan pengujian yang kami jalankan: NOT NULL, UNIQUE, CHECK, DEFAULT, PRIMARY dan FOREIGN KEY, celah NULL, pengaturan kunci …
Baca artikel →Basis data & SQLPenjelasan Fungsi Tanggal SQL: Menambah, Membandingkan dan Mengelompokkan Tanggal Tanpa Bug
Fungsi tanggal SQL dijelaskan dengan kueri yang kami jalankan: penambahan interval, kejutan akhir bulan, perbedaan tanggal, jebakan ANTARA, pengelom…
Baca artikel →Pengembangan perangkat lunakPenjelasan Python asyncio: async, menunggu, mengumpulkan dan TaskGroup Dengan Waktu Nyata
Python asyncio dijelaskan dengan kode yang kami atur waktunya: coroutine, menunggu, mengumpulkan, TaskGroup, penanganan kesalahan, batas waktu, memb…
Baca artikel →Pengembangan perangkat lunakDebounce vs Throttle dalam JavaScript: Cara Kerjanya, Kapan Menggunakannya, Diuji
Debounce vs throttle dalam JavaScript dijelaskan dengan pengaturan waktu yang kami ukur di Node.js: cara kerja masing-masing, implementasi sederhana…
Baca artikel →Pengembangan perangkat lunakPenjelasan Manajer Konteks Python: Pernyataan with, lib konteks, dan Penggunaan Nyata
Manajer konteks Python menjelaskan dengan kode yang kami jalankan: cara kerja, __enter__ dan __exit__, kontekslib.contextmanager, penekan, ExitStack…
Baca artikel →Kecerdasan buatanPenjelasan Suhu dan Top-p LLM: Bagaimana Model AI Memilih Kata Berikutnya
Suhu LLM dan top-p dijelaskan dengan simulasi yang kami jalankan: bagaimana probabilitas dibentuk kembali, apa yang dipertahankan top-p, pengaturan …
Baca artikel →DevOpsPenjelasan YAML: Sintaks, Masalah Norwegia, dan Jebakan Lain yang Kami Uji
YAML menjelaskan dengan tes parser: sintaks dasar, daftar dan peta, masalah Norwegia, versi berubah menjadi float, kode pos oktal, waktu sexagesimal…
Baca artikel →DevOpsPenjelasan Cron Jobs: Sintaks, Jadwal Sebenarnya, dan Kesalahan yang Melanggarnya
Pekerjaan Cron dijelaskan dengan jadwal yang kami verifikasi: lima bidang, operator, contoh nyata, jebakan hari dalam sebulan ATAU hari dalam seming…
Baca artikel →Kecerdasan buatanPenjelasan Halusinasi AI: Mengapa Model Bahasa Memperbaiki Masalah dan Cara Menguranginya
Halusinasi AI menjelaskan: apa itu, mengapa model bahasa memproduksinya, tipe umum, cara menguranginya dengan landasan dan petunjuk, dan pemeriksaan…
Baca artikel →DevOpsPenjelasan Variabel Lingkungan: File .env, Rahasia, dan Konfigurasi Dilakukan dengan Benar
Variabel lingkungan dijelaskan dengan contoh Python yang kami jalankan: membaca dan mengaturnya, mengapa setiap nilai berupa string, file .env, pewa…
Baca artikel →Pengembangan perangkat lunakPenjelasan Pembatasan Kecepatan API: Algoritma, Header, dan Penanganan 429 Kesalahan
Pembatasan laju API dijelaskan dengan simulasi yang kami jalankan: keranjang token, jendela tetap, jendela geser, respons 429, header batas laju, pe…
Baca artikel →Otomatisasi pengujianMengejek dengan Python: unittest.mock, patch dan Kesalahan yang Membuat Tes Berbohong
Mengejek dengan Python dengan unittest.mock, menguji: Mock dan return_value, side_effect, menambal di mana nama digunakan, spesifikasi dan autospec,…
Baca artikel →Pengujian perangkat lunakPenjelasan Cakupan Kode: Cakupan Jalur vs Cabang dan Apa Arti 100% Sebenarnya
Cakupan kode dijelaskan dengan coverage.py yang sebenarnya dijalankan: cakupan garis, cabang dan kondisi, membaca laporan, mengapa cakupan 100% masi…
Baca artikel →Basis data & SQLDELETE vs TRUNCATE vs DROP dalam SQL: Perbedaan, Rollback dan Kapan Menggunakan Masing-Masing
DELETE vs TRUNCATE vs DROP dijelaskan dengan SQL yang diuji: apa yang dihapus, rollback, pemicu, reset identitas, kecepatan, dan perbedaan PostgreSQ…
Baca artikel →Basis data & SQLPenjelasan Tampilan SQL: Membuat, Menggunakan, dan Menghindari Kesalahan, Dengan Contoh
Tampilan SQL dijelaskan dengan kueri yang kami jalankan: membuat tampilan, hasil langsung, menyembunyikan kolom, kinerja, tampilan yang dapat diperb…
Baca artikel →Pengembangan perangkat lunakAntarmuka TypeScript vs Tipe: Perbedaan Nyata, Diuji Dengan Kompiler
Antarmuka TypeScript vs tipe, diperiksa dengan kompiler sebenarnya: apa yang bisa dilakukan keduanya, apa yang hanya bisa dilakukan satu orang, peng…
Baca artikel →Pengembangan perangkat lunakPenjelasan Python *args dan **kwargs: Fungsi Fleksibel Dengan Contoh Jelas
Python *args dan **kwargs dijelaskan dengan kode yang kami jalankan: pengepakan dan pembongkaran, urutan parameter, argumen hanya kata kunci dan pos…
Baca artikel →Pengembangan perangkat lunakFungsi Python Lambda: Sintaks, Kegunaan Sebenarnya, dan Kapan Tidak Digunakan
Fungsi python lambda dijelaskan dengan kode yang kami jalankan: sintaksis, pengurutan dengan kunci, peta dan filter, penutupan, jebakan pengikatan a…
Baca artikel →Kecerdasan buatanApa Itu Agen AI? Cara Kerjanya, Dengan Agent Loop Sederhana yang Dapat Anda Jalankan
Apa itu agen AI? Panduan sederhana tentang loop agen, alat, memori, dan pagar pembatas, dengan loop Python kecil yang kami jalankan, risiko nyata da…
Baca artikel →DevOpsPemantauan vs Observabilitas: Perbedaan Nyata, Dengan Log, Metrik, dan Jejak
Penjelasan pemantauan vs observabilitas: kegagalan yang diketahui dan tidak diketahui, log, metrik dan jejak, penelusuran insiden checkout, sinyal e…
Baca artikel →DevOpsVolume Docker vs Bind Mounts: Pertahankan Data Kontainer dengan Cara yang Benar
Volume Docker vs pengikatan pengikat dijelaskan: mengapa data kontainer menghilang, volume yang diberi nama, pengikatan pengikatan, tmpfs, contoh Tu…
Baca artikel →Otomatisasi pengujianTDD vs BDD: Perbedaan Utama, Satu Fitur Dibangun dengan Dua Cara dan Kapan Menggunakan Masing-masing
TDD vs BDD dijelaskan dengan satu fitur diskon yang dibuat dengan dua cara: refactor merah-hijau dengan kode yang kami jalankan, skenario Mengingat-…
Baca artikel →Pengujian perangkat lunakUser Acceptance Testing (UAT): Proses, Checklist dan Contoh Nyata
Pengujian penerimaan pengguna menjelaskan: siapa yang menjalankannya, perbedaannya dengan QA, proses tujuh langkah, templat kasus uji UAT, daftar pe…
Baca artikel →Basis data & SQLPenjelasan Nilai NULL SQL: IS NULL, COALESCE, NULLIF dan Jebakan yang Harus Dihindari
Nilai SQL NULL dijelaskan dengan kueri yang kami jalankan: logika tiga nilai, IS NULL, COALESCE, NULLIF, cara agregat, penggabungan, dan pengurutan …
Baca artikel →Basis data & SQLPernyataan SQL CASE WHEN: Sintaks, Contoh Nyata dan Kesalahan Umum
SQL CASE KETIKA dijelaskan dengan kueri yang kami jalankan: formulir sederhana dan dicari, urutan kondisi, pivot dengan SUM, trik COUNT, pengurutan …
Baca artikel →Pengembangan perangkat lunakApa itu JWT? Token Web JSON Dijelaskan Dengan Contoh Kerja
Apa itu JWT? JSON Web Tokens menjelaskan: tiga bagian, token yang dibuat dan dirusak dalam kode yang kami jalankan, sesi JWT vs, penyimpanan, token …
Baca artikel →Pengembangan perangkat lunakPenjelasan Loop Acara JavaScript: Call Stack, Microtasks, dan Timer Dengan Contoh
Perulangan peristiwa JavaScript dijelaskan dengan kode yang kami jalankan: tumpukan panggilan, antrian tugas dan tugas mikro, mengapa setTimeout 0 t…
Baca artikel →Pengembangan perangkat lunakGenerator Python dan Penjelasan Hasil: Menghemat Memori Dengan Contoh Nyata
Generator dan hasil Python dijelaskan dengan kode yang kami jalankan: bagaimana mereka menjeda dan melanjutkan, mengukur penghematan memori, saluran…
Baca artikel →Kecerdasan buatanApa itu Embedding? Kesamaan Vektor dan Kosinus Dijelaskan Secara Sederhana
Apa itu embeddings? Panduan bahasa sederhana tentang vektor, kesamaan kosinus, dan penelusuran semantik, dengan contoh kecil yang kami jalankan, pen…
Baca artikel →DevOpsPenerapan Biru-Hijau vs Canary: Perbedaan, Kompromi, dan Cara Memilih
Penjelasan penerapan blue-green vs canary: cara kerja masing-masing, biaya, risiko dan rollback, pengelompokan pengguna stabil yang kami uji, migras…
Baca artikel →Otomatisasi pengujianTes Tidak Stabil: Apa Penyebabnya dan Cara Memperbaikinya untuk Kebaikan
Pengujian yang tidak stabil dijelaskan dengan demo yang kami jalankan: penyebab utama, cara mengonfirmasi dan mendiagnosisnya, perbaikan waktu yang …
Baca artikel →Pengujian perangkat lunakLoad Testing vs Stress Testing: Perbedaan, Metrik dan Contoh k6
Penjelasan pengujian beban vs pengujian stres: apa yang dibuktikan masing-masing, pengujian lonjakan dan rendam, metrik yang penting, mengapa rata-r…
Baca artikel →Pengujian perangkat lunakKasus Uji vs Skenario Uji: Perbedaan Utama, Contoh, dan Kapan Menggunakan Masing-masing
Penjelasan kasus uji vs skenario pengujian: definisi yang jelas, tabel berdampingan, satu fitur pengaturan ulang kata sandi yang diambil dari skenar…
Baca artikel →Basis data & SQLOptimasi Kueri SQL: Baca Rencana Eksekusi dan Perbaiki Kueri Lambat, Dengan Pengaturan Waktu
Pengoptimalan kueri SQL diuji pada sejuta baris: membaca rencana eksekusi, menambahkan indeks yang tepat, memperbaiki filter yang tidak dapat disarg…
Baca artikel →Basis data & SQLSQL UNION vs UNION ALL: Perbedaan, Contoh dan Kinerja Diuji
SQL UNION vs UNION ALL dijelaskan dengan kueri yang kami jalankan: duplikat, aturan yang diikuti keduanya, bug data nyata, kinerja terukur, INTERSEC…
Baca artikel →Pengembangan perangkat lunakTutorial API Pengambilan JavaScript: GET, POST, Penanganan Kesalahan, dan Batas Waktu
Tutorial JavaScript Fetch API diuji pada server lokal: GET dan POST, mengapa 404 tidak muncul, bantuan yang dapat digunakan kembali, string kueri, b…
Baca artikel →Pengembangan perangkat lunakPenanganan File Python: Baca, Tulis, CSV, JSON dan pathlib Dengan Contoh
Penanganan file Python dijelaskan dengan kode yang kami jalankan: mode terbuka, dengan, membaca file besar, CSV, JSON, pathlib, file biner, penulisa…
Baca artikel →Pengembangan perangkat lunakKelas dan Objek Python: Tutorial OOP Dengan Contoh Nyata
Kelas dan objek Python dijelaskan dengan kode yang kami jalankan: __init__, metode, atribut kelas vs instance, warisan, properti, metode dunder, kel…
Baca artikel →Kecerdasan buatanApa Itu Model Bahasa Besar? Bagaimana LLM Bekerja, Dijelaskan Tanpa Hype
Apa yang dimaksud dengan model bahasa besar? LLM dijelaskan dalam bahasa sederhana: token, penyematan, perhatian, pelatihan, jendela suhu dan kontek…
Baca artikel →DevOpsPerintah Linux untuk Pemula: Panduan Terminal Penting Dengan Contoh
Perintah Linux untuk pemula, dikelompokkan berdasarkan tugas: navigasi, file, melihat log, grep, pipa, izin, proses dan arsip, dengan contoh analisi…
Baca artikel →Otomatisasi pengujianSelenium vs Penulis Drama: Perbedaan Utama, Perbandingan Kode, dan Mana yang Harus Dipilih
Selenium vs Playwright dibandingkan: arsitektur, menunggu, dukungan browser dan bahasa, debugging, pengujian yang sama di kedua alat, saran migrasi …
Baca artikel →Pengujian perangkat lunakPartisi Ekivalensi: Teknik Desain Tes Dijelaskan Dengan Contoh yang Dikerjakan
Penjelasan partisi ekivalensi: cara menemukan partisi yang valid dan tidak valid, contoh yang berfungsi untuk usia, kata sandi dan kupon, pengujian …
Baca artikel →Pengujian perangkat lunakSeverity vs Priority dalam Pengujian Perangkat Lunak: Perbedaan, Matriks dan Contoh Nyata
Keparahan vs prioritas dalam pengujian perangkat lunak dijelaskan: definisi yang jelas, matriks empat arah dengan contoh, skala level, siapa yang me…
Baca artikel →Basis data & SQLTutorial Subkueri SQL: Jenis, Subkueri yang Berkorelasi, dan ADA Dengan Contoh
Tutorial subkueri SQL dengan kueri yang kami jalankan: subkueri skalar, IN, FROM dan SELECT, subkueri yang berkorelasi, EXISTS, jebakan NOT IN NULL …
Baca artikel →Basis data & SQLPenjelasan Transaksi SQL dan ACID: COMMIT, ROLLBACK dan Tingkat Isolasi
Transaksi SQL dan ACID dijelaskan dengan transfer bank yang kami jalankan: COMMIT, ROLLBACK, savepoint, kunci, tingkat isolasi, pembacaan kotor, keb…
Baca artikel →Pengembangan perangkat lunakLembar Cheat Perintah Git: Perintah yang Sebenarnya Anda Gunakan, Beserta Contohnya
Lembar contekan perintah Git yang dikelompokkan berdasarkan tugas: pengaturan, pementasan, cabang, remote, simpanan, riwayat, dan pembatalan kesalah…
Baca artikel →Pengembangan perangkat lunakPenjelasan Janji JavaScript: lalu, tangkap, Janji.semua, dan Kesalahan Umum
Janji JavaScript dijelaskan dengan kode yang kami jalankan: status, rantai lalu dan tangkap, penanganan kesalahan, Promise.all, allSettled, race dan…
Baca artikel →Pengembangan perangkat lunakTutorial Kamus Python: Metode, Contoh dan Pola Umum
Tutorial kamus Python dengan kode yang kami jalankan: membuat, membaca dan memperbarui dicts, metode utama, penggabungan, pemahaman, pola penghitung…
Baca artikel →Kecerdasan buatanApa itu RAG? Generasi Retrieval-Augmented Dijelaskan Dengan Contoh Kerja
Apa itu RAG? Generasi yang ditambah pengambilan dijelaskan langkah demi langkah: pengindeksan, pemotongan, penyematan, pengambilan, contoh kecil Pyt…
Baca artikel →DevOpsTutorial Terraform untuk Pemula: Infrastruktur sebagai Kode Dari File Pertama hingga Modul
Tutorial Terraform untuk pemula: mulai tanpa akun cloud, pelajari init, rencanakan dan terapkan, lalu variabel, keluaran, status, modul, dan alur ke…
Baca artikel →DevOpsDocker vs Kubernetes: Perbedaan Utama, Cara Kerja Sama, dan Yang Anda Butuhkan
Docker vs Kubernetes menjelaskan: apa yang dilakukan masing-masing, aplikasi yang sama dijalankan dengan keduanya, Docker Compose dan Swarm dibandin…
Baca artikel →Otomatisasi pengujianTutorial Pytest untuk Pemula: Fixture, Parametrize dan Contoh Nyata
Tutorial pytest untuk pemula dengan pengujian yang kami jalankan di pytest 9.2: pernyataan, perlengkapan, parametrize, conftest, marker, tmp_path, m…
Baca artikel →Pengujian perangkat lunakSiklus Hidup Pengujian Perangkat Lunak (STLC): 6 Fase, Kriteria Masuk dan Keluar, Contoh
Siklus hidup pengujian perangkat lunak menjelaskan: enam fase STLC dengan kriteria masuk dan keluar, hasil, contoh fitur login yang berfungsi, STLC …
Baca artikel →Pengembangan perangkat lunakGit merge vs rebase: perbedaan, contoh, dan kapan memakai masing-masing
Git merge vs rebase dijelaskan dengan keluaran log nyata, tabel perbandingan, aturan emas rebase, dan alur kerja tim yang aman.
Baca artikel →Pengembangan perangkat lunakList Comprehension Python: Sintaks, Contoh, dan Kapan Harus Dihindari
List comprehension Python dijelaskan: sintaks, filter, if-else, perulangan bersarang, waktu yang diukur, dan kapan perulangan for biasa lebih baik.
Baca artikel →Basis data & SQLPenjelasan SQL JOIN dengan Contoh (Inner, Left, Right, Full)
Pahami SQL JOIN langkah demi langkah dengan tabel dan query contoh: INNER, LEFT, RIGHT, FULL, CROSS, dan SELF, plus kesalahan umum dan tips performa.
Baca artikel →