Panduan Thunder Client: Cara Menggunakan Asersi

Thunder Client adalah alat revolusioner dalam dunia pengujian API, terutama karena ini adalah yang pertama menawarkan asersi berbasis GUI. Berbeda dengan Postman dan klien lainnya yang memerlukan scripting ekstensif untuk tes dasar, Thunder Client memungkinkan Anda melakukan tes standar hanya dengan beberapa pilihan dropdown—tanpa perlu pengetahuan scripting. Panduan ini akan membimbing Anda melalui cara menggunakan asersi berbasis GUI ini dan memperkenalkan Anda pada alat alternatif, EchoAPI for VS Code.

Asersi Berbasis GUI

Asersi berbasis GUI dari Thunder Client menyederhanakan proses pengujian. Berikut adalah hal-hal yang dapat Anda lakukan dengannya:

1. Pemeriksaan String, Angka, Jumlah, dan Tipe: Anda dapat dengan mudah mengatur tes untuk berbagai tipe data dan kondisi.
2. Validasi Skema JSON: Validasi respons API Anda terhadap skema JSON tanpa menulis kode apa pun.
3. Mengatur Ulang Tes: Atur urutan tes Anda dengan antarmuka drag-and-drop yang sederhana.

Asersi berbasis GUI menghemat Anda dari menulis kode boilerplate, membuat proses pengujian lebih lancar dan cepat.

Pengujian Array

Thunder Client memungkinkan Anda menguji array dengan filter spesifik. Filter ini termasuk operasi seperti contains (*=), startsWith (^=), dan endsWith ($=). Anda juga dapat mengakses item array menggunakan nomor indeks negatif.

Pengujian XML

Untuk respons XML, Thunder Client menawarkan opsi Convert To Json. Fitur ini memungkinkan Anda mengonversi respons XML ke dalam format JSON sehingga Anda dapat memanfaatkan asersi berbasis JSON.

1. Ketika Anda menerima respons XML, pilih Convert To Json.
2. Gunakan dropdown Json Query untuk melakukan tes Anda.
3. Simpan properti respons ke lingkungan menggunakan dropdown Set Env Variable.

Validasi Skema

Memvalidasi respons terhadap skema JSON di Thunder Client sangat mudah:

1. Buat file skema di workspace Anda.
2. Simpan path file skema dalam variabel lingkungan.
3. Pilih skema di tab Tests dan gunakan filter readFile.

Contoh Skema:

{
    "type": "object",
    "additionalProperties": false,
    "properties": {
        "fraction": { "type": "number" },
        "balance": { "type": "number" },
        "bignumber": { "type": "integer" },
        "isNumber": { "type": "null" }
    },
    "required": ["balance", "bignumber", "fraction", "isNumber"],
    "title": "Welcome4"
}

Asersi Berbasis Skrip (Fitur Berbayar)

Untuk kebutuhan pengujian yang lebih lanjut, versi berbayar Thunder Client memungkinkan Anda menulis asersi tes kustom menggunakan JavaScript atau pustaka Chai.

Contoh Asersi Dasar:

let success = tc.response.status == 200;
let json = tc.response.json;
let containsThunder = json.message?.includes("thunder");

tc.test("Kode respons adalah 200", success);
tc.test("Respons mengandung kata 'thunder'", containsThunder);

Contoh Asersi Chai:

tc.test("Kode respons diharapkan 200", function () {
    expect(tc.response.status).to.equal(200);
});

tc.test("Kode respons adalah 200", function () {
    assert.equal(tc.response.status, 200);
});

EchoAPI for VS Code: Alternatif yang Direkomendasikan

Jika Anda mencari alternatif untuk Thunder Client, pertimbangkan EchoAPI for VS Code. Ini adalah alat kolaboratif yang ringan untuk pengembangan dan pengujian API, mendukung fitur seperti Scratch Pad, desain API, debugging, pengujian otomatis, dan pengujian beban—semua tanpa perlu login.

Keuntungan EchoAPI:

1. Tidak perlu login
2. Mendukung Scratch Pad
3. Sangat ringan
4. 100% kompatibel dengan sintaks skrip Postman

EchoAPI dilengkapi dengan plugin untuk IntelliJ IDEA, VS Code, dan bahkan ekstensi penangkap permintaan Chrome, menjadikannya alternatif yang kuat bagi pengembang yang mencari fleksibilitas dan kemudahan penggunaan.

Dengan memanfaatkan fitur-fitur canggih dari Thunder Client dan mempertimbangkan EchoAPI sebagai alternatif, Anda dapat secara signifikan meningkatkan efisiensi dalam pengujian API Anda. Selamat menguji!