Panduan Thunder Client: Panduan Akhir untuk Menguasai Thunder Client CLI

2021, pengujian API mengalami revolusi dengan diluncurkannya ekstensi Thunder Client untuk VS Code.

2021, pengujian API mengalami revolusi dengan diluncurkannya ekstensi Thunder Client untuk VS Code. Alat inovatif ini adalah yang pertama memperkenalkan klien API berbasis GUI langsung di dalam VS Code, secara signifikan meningkatkan pengalaman pengujian API. Membangun dari kesuksesan tersebut, Thunder Client CLI diperkenalkan sebagai alat baris perintah yang kuat, yang semakin mempermudah pengujian API bagi para pengembang.

Thunder Client CLI

Fitur Utama Thunder Client CLI

Thunder Client CLI, yang hanya tersedia dalam versi berbayar, menawarkan berbagai fitur canggih:

  • Mudah dan Sederhana: Alat CLI yang intuitif.
  • Integrasi Tanpa Hambatan: Bekerja secara seamless dengan Ekstensi Thunder Client.
  • Jalankan Permintaan/Koleksi: Eksekusi permintaan API dan lihat hasilnya langsung dari terminal.
  • Pewarnaan Sintaks: Nikmati pewarnaan sintaks dan gunakan tema VS Code di terminal.
  • Buka UI dari CLI: Buka UI permintaan atau koleksi dari terminal.
  • Meningkatkan Perintah cURL: Tambahkan fitur kuat ke perintah cURL dasar.
  • Integrasi CI/CD: Mudah diintegrasikan ke dalam pipeline integrasi dan pengiriman berkelanjutan Anda.

Silakan merujuk ke artikel blog asli kami untuk penjelasan mendalam mengenai CLI.

Memulai dengan Thunder Client CLI

Instalasi

Sebelum memulai, pastikan Anda telah menginstal Node versi 18 atau lebih tinggi serta memiliki langganan Thunder Client.

  1. Perbarui Ekstensi: Pastikan Anda menggunakan versi terbaru.
  2. Instal CLI: Jalankan npm i -g @thunderclient/cli dari direktori utama proyek Anda.

Pengaturan VS Code

Untuk mengakses pengaturan Thunder Client dari CLI, pengaturan tersebut harus berada dalam lingkup workspace. Untuk workspace multi-root, gunakan pengaturan spesifik folder.

Menjalankan Permintaan dengan Thunder Client CLI

Jalankan permintaan API dengan efisien menggunakan perintah sederhana. Berikut caranya:

tc 'requestNameOrId'
Jalankan Permintaan

Contohnya:

tc 'welcome' --log 1,2,7

Perintah ini menampilkan header permintaan, body permintaan, dan body respons.

Membuka UI dari CLI

Gunakan argumen --ui untuk membuka dan menjalankan permintaan di UI ekstensi:

tc 'welcome' --ui
Buka UI dari CLI

Mengelola Koleksi

Anda dapat menjalankan seluruh koleksi permintaan dengan cara yang sama mudahnya:

  • Koleksi Tunggal: tc --col 'colNameOrId'
  • Beberapa Koleksi: tc --col "colNameOrId1,colNameOrId2"
  • Semua Koleksi: tc --col all
Jalankan Koleksi

Menggunakan Berbagai Lingkungan

Jalankan koleksi atau permintaan dengan berbagai lingkungan menggunakan argumen --env:

tc --col 'colNameOrId' --env 'Staging'

Integrasi File Data

Sediakan berbagai file data menggunakan argumen --data-file:

tc --col 'colNameOrId' --data-file 'relativePathOrFullPath'

Pelaporan

Hasilkan laporan terperinci dalam berbagai format:

tc --col 'User' --report xml,html

Meningkatkan Perintah cURL

Thunder Client CLI menjadikan perintah cURL lebih kuat. Cukup tambahkan prefiks tc pada perintah cURL Anda untuk mendapatkan output yang terformat, pewarnaan sintaks, dan riwayat permintaan.

Integrasi cURL
tc curl 'http://httpbin.org/anything' --name 'Curl Req1' --col User

Integrasi CI/CD

Integrasikan Thunder Client CLI ke dalam pipeline CI/CD Anda dengan mudah. Hasilkan laporan dan pastikan pengujian API yang lancar dalam alur kerja otomatis.

Contoh GitHub Action

name: TestBuild
on: workflow_dispatch

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Install Node
        uses: actions/setup-node@v4
        with:
          node-version: 20
      - name: Install Thunder Client CLI
        run: npm install -g @thunderclient/cli
      - name: Buat Direktori untuk hasil
        run: mkdir -p thunder-reports
      - name: Jalankan koleksi Thunder Client
        run: tc --col "ColNameOrId" --report cli,json,xml,html --log 8
      - name: Keluaran Rincian eksekusi
        uses: actions/upload-artifact@v4
        with:
          name: RunReports
          path: thunder-reports

Bantuan dan Debugging

CLI dilengkapi dengan layar bantuan yang ramah pengguna dan opsi debugging. Gunakan tc --help untuk memulai dan tc --debug untuk pemecahan masalah.

Layar Bantuan

Alternatif Python: EchoAPI for VS Code

Alternatif yang Perlu Dipertimbangkan: EchoAPI.png

Mencari alternatif? Coba EchoAPI for VS Code, alat kolaborasi ultra-ringan untuk pengembangan API. Ini mendukung Scratch Pad, menawarkan desain API, debugging, pengujian otomatis, dan pengujian beban, semua tanpa memerlukan login.

Dengan segala fitur Thunder Client CLI ini, Anda bisa mengoptimalkan alur kerja pengujian API Anda. Dari penggunaan CLI sederhana hingga integrasi CI/CD, EchoAPI for VS Code menawarkan alternatif yang ringan dan praktis bagi pengembang yang mencari solusi untuk pengembangan dan pengujian API yang lebih efektif. Cobalah EchoAPI for VS Code hari ini dan rasakan perbedaan tersebut!