Tutorial ini merupakan pengenalan API Testing menggunakan Karate Framework. Pelajari tentang struktur Karate Test Script dan langkah-langkah untuk membuat skrip pengujian pertama:
API adalah singkatan dari Application Programming Interface. Secara sederhana, kita dapat mendefinisikannya sebagai perantara perangkat lunak yang memungkinkan komunikasi antar aplikasi.
Kami membutuhkan pengujian API karena:
- Hasil dipublikasikan lebih cepat, sehingga tidak perlu lagi menunggu untuk melihat apakah API berfungsi dengan baik.
- Dengan respons yang lebih cepat, penerapan API ini juga menjadi lebih cepat, sehingga memungkinkan waktu penyelesaian yang cepat.
- Deteksi kegagalan sejak dini, bahkan sebelum UI aplikasi dibuat, memungkinkan kami untuk mengurangi risiko dan memperbaiki kesalahan.
- Pengiriman dalam skala besar dapat dilakukan dalam waktu yang lebih singkat.
Untuk dapat bekerja pada API Testing, kami memiliki berbagai alat yang tersedia di pasar seperti Postman, Mocha, dan Chai. Ini telah menunjukkan hasil yang baik dan penggunaan yang efektif untuk menguji API, namun, ini sangat dipengaruhi oleh kode. Untuk dapat menggunakannya, seseorang harus memiliki pengetahuan teknis dan akrab dengan bahasa pemrograman.
Karate Framework dengan indah memecahkan masalah ini dari perangkat lunak sebelumnya.
Apa Itu Kerangka Kerja Karate
Karate? Mari kita bicara tentang Karate. Apakah itu yang dari Jepang? Bagaimana menurut Anda? Mungkin saja Bruce Lee yang hebat telah mengembangkannya di waktu luangnya.
Meskipun kami ingin mempelajari akar Karate yang menarik, untuk saat ini, mari kita bahas tentang Alat Karate yang telah dikembangkan oleh Peter Thomas salah satu alat bantu hebat yang hadir untuk membantu para penguji API.
Framework Karate mengikuti gaya penulisan program Cucumber yang mengikuti pendekatan BDD. Sintaksnya mudah dimengerti oleh non-programmer. Dan framework ini adalah satu-satunya alat pengujian API yang telah menggabungkan API Automation dan pengujian kinerja ke dalam satu alat mandiri.
Ini memberi pengguna kemampuan untuk menjalankan kasus uji secara Paralel dan melakukan pemeriksaan JSON & XML.
Dengan informasi ini, beberapa poin penting dapat disimpulkan untuk lebih memahami alat Karate secara detail:
- Karate adalah kerangka kerja pengujian BDD, bukan TDD.
- Fitur ini merupakan pengubah permainan karena memungkinkan penggunaan dan akses yang lebih banyak oleh banyak orang tanpa memandang latar belakang teknis atau kapasitas mereka.
- Ini memanfaatkan file fitur Cucumber dan bahasa Gherkins untuk menulis tes yang sangat mudah dimengerti.
Semua fitur ini menjadikannya salah satu alat otomatisasi yang paling disukai yang tersedia saat ini.
Sejarah Kerangka Kerja Karate
Dibuat oleh ' Peter Thomas Pada tahun 2017, perangkat lunak ini bertujuan untuk membuat fungsionalitas pengujian tersedia untuk semua orang. Perangkat lunak ini ditulis dalam bahasa Java dan sebagian besar orang mengharapkan file-filenya juga dalam bahasa yang sama, namun untungnya, tidak demikian.
Perangkat lunak otomasi adalah perpanjangan dari Cucumber, oleh karena itu mewarisi penggunaan file Gherkins dalam pengoperasiannya. Perbedaan besar di antara keduanya adalah Karate tidak menggunakan Java saat pengujian, tetapi Cucumber melakukannya.
Ini adalah alasan utama mengapa Karate cocok untuk non-programmer karena sintaks Gherkins sangat mudah dibaca dan komprehensif. Inilah alasan mengapa Karate paling cocok dan direkomendasikan untuk masuk ke dunia pengujian API otomatis.
Berikut ini adalah beberapa fitur dari Karate Testing Framework:
- Menggunakan bahasa Gherkins yang mudah dipahami.
- Tidak memerlukan pengetahuan pemrograman teknis seperti Java.
- Ini didasarkan pada standar Cucumber yang populer.
- Mudah untuk membuat kerangka kerja.
- Pengujian paralel adalah fungsionalitas inti yang disediakan oleh Karate itu sendiri, oleh karena itu kita tidak perlu bergantung pada Maven, Gradle dll.
- UI untuk men-debug Tes.
- Memanggil file fitur dari file lain.
- Menyediakan dukungan untuk Pengujian Driver Data yang dibangun secara internal, sehingga tidak perlu bergantung pada kerangka kerja eksternal.
- Laporan Istirahat Native bawaan. Ditambah lagi, dapat diintegrasikan dengan Cucumber untuk Laporan UI yang lebih baik dan lebih jelas.
- Menyediakan dukungan internal untuk mengalihkan konfigurasi di berbagai lingkungan pengujian (QA, Stage, Prod, Pre-Prod).
- Dukungan tanpa batas untuk integrasi CI/CD yang dapat berguna.
- Mampu menangani berbagai panggilan HTTP:
- Dukungan Soket Web
- Permintaan SOAP
- HTTP
- Penanganan cookie browser
- HTTPS
- Data bentuk HTML
- Permintaan XML
Membandingkan Karate Vs Istirahat yang Terjamin
Yakinlah Ini adalah perpustakaan berbasis Java untuk menguji layanan REST. Ini menggunakan bahasa Java untuk menulis baris kode. Ini membantu dalam menguji berbagai kategori permintaan, yang selanjutnya menghasilkan verifikasi kombinasi logika bisnis yang berbeda.
Kerangka Kerja Karate Alat berbasis Cucumber/Gherkins, yang digunakan untuk menguji layanan SOAP & REST.
Tabel berikut mencantumkan beberapa perbedaan yang lebih menonjol antara Rest-Assured & Karate Framework:
| S.No | Dasar | Kerangka Kerja Karate | DIJAMIN RESTASI |
|---|---|---|---|
| 1 | Bahasa | Menggunakan kombinasi mentimun dan ketimun | Menggunakan Bahasa Java |
| 2 | Ukuran Kode | Biasanya, baris kode lebih sedikit, karena mengikuti struktur seperti mentimun | Baris kode lebih banyak karena melibatkan penggunaan bahasa Java |
| 3 | Diperlukan Pengetahuan Teknis | Non-Programmer dapat dengan mudah menulis kode Gherkins | Pengetahuan teknis diperlukan untuk menulis kode Java |
| 4 | Pengujian Berbasis Data | Perlu menggunakan TestNG atau yang setara untuk mendukung hal yang sama | Tag internal dapat digunakan untuk mendukung pengujian data |
| 5 | Apakah menyediakan dukungan panggilan SOAP | Ya, ini memang menyediakan | Ini hanya terkait dengan permintaan REST |
| 6 | Pengujian Paralel | Ya, pengujian paralel dengan mudah didukung dengan pembuatan laporan paralel juga | Meskipun banyak orang telah mencoba melakukan ini, tingkat kegagalannya lebih banyak daripada tingkat keberhasilannya |
| 7 | Pelaporan | Ini menyediakan pelaporan internal, sehingga tidak perlu bergantung pada plugin eksternal. Kami bahkan dapat mengintegrasikannya dengan plugin pelaporan Cucumber untuk UI yang lebih baik. | Harus bergantung pada Plugin Eksternal seperti Junit, TestNG |
| 8 | Dukungan CSV untuk Data eksternal | Ya, dari Karate 0.9.0 | Tidak, harus menggunakan kode atau pustaka Java |
| 9 | Otomatisasi UI Web | Ya, dari Karate 0.9.5 Otomatisasi Web-UI dimungkinkan | Tidak, ini tidak didukung |
| 10 | Contoh DAPATKAN | Diberikan param val1 = 'nama1' | diberikan(). |
Oleh karena itu, seperti yang ditunjukkan oleh perbedaan-perbedaan di atas, dapat dikatakan bahwa Karate adalah salah satu hal termudah yang dapat dilakukan oleh siapa saja.
Alat yang Dibutuhkan Untuk Bekerja Dengan Kerangka Kerja Karate
Sekarang, karena kita telah memiliki pengetahuan dasar tentang Karate Framework, mari kita lihat proses dan alat yang diperlukan dalam menyiapkan lingkungan Karate.
#1) Gerhana
Eclipse adalah Lingkungan Pengembangan Terpadu yang digunakan dalam bidang pemrograman komputer. Sebagian besar digunakan untuk Pemrograman Java. Seperti yang disebutkan sebelumnya, Karate ditulis dalam bahasa Java, jadi lebih masuk akal mengapa Eclipse adalah IDE yang tepat untuk perangkat lunak pengujian API. Alasan lain adalah bahwa ini adalah alat sumber terbuka, dan ini adalah alasan yang cukup kuat untuk memilih alat ini.
Catatan: Kita bahkan dapat menggunakan IntelliJ, Visual Studio, dan editor lain yang tersedia di pasaran.
# 2) Maven
Ini adalah alat otomatisasi pembangunan yang digunakan terutama untuk membangun proyek Java. Ini adalah salah satu cara untuk mengatur lingkungan Karate dan menulis kode. Untuk mengatur Eclipse Anda dengan persyaratan Maven, Anda dapat mengklik di sini untuk instalasi Maven.
Saat bekerja di Maven, gunakan dependensi Maven yang akan membantu Anda mendukung Karate Framework.
Ketergantungan berikut ini akan digunakan dengan Maven di pom.xml.
com.intuit.karate karate-apache 0.9.5 test com.intuit.karate karate-junit4 0.9.5 test
Catatan: Versi terbaru mungkin tersedia di repositori Maven.
# 3) Gradle
Gradle adalah alternatif dari Maven dan dapat digunakan dalam kapasitas yang sama. Keduanya memiliki kesamaan dan perbedaan, tetapi dapat digunakan secara setara dalam menyiapkan lingkungan untuk kode Karate kita.
Lebih mudah digunakan, fleksibel, dan direkomendasikan untuk digunakan ketika aplikasi kita memiliki beberapa kebutuhan modularisasi dan manajemen dengan banyak plug-in. Kode penyiapan Gradle akan terlihat seperti ini,
testCompile 'com.intuit.karate:karate-junit4:0.6.0' testCompile 'com.intuit.karate:karate-apache:0.6.0'
Catatan: Anda dapat menggunakan MAVEN atau GRADLE.
#4) Pengaturan Lingkungan Java di Sistem Anda
Perlu menyiapkan lingkungan JDK dan JRE untuk memulai dengan skrip Karate Framework.
Struktur Naskah Tes Karate
Skrip tes Karate dikenal dengan kepemilikan ekstensi ".feature." Properti ini diwarisi dari Cucumber. Pengorganisasian file dalam konvensi Java juga sama-sama diizinkan. Anda bebas mengatur file Anda sesuai dengan konvensi paket Java.
Namun, pedoman Maven menginstruksikan bahwa penyimpanan file non-Java dilakukan secara terpisah, dan dilakukan di src/test/resources Dan file Java disimpan di bawah src/main/jawa .
Namun, sesuai dengan pencipta Karate Framework, mereka sangat percaya bahwa kita menyimpan file Java dan non-Java secara berdampingan. Menurut mereka, akan lebih mudah untuk mencari file *.java dan *.feature jika disimpan bersama, daripada mengikuti struktur standar Maven.
Hal ini dapat dengan mudah dilakukan dengan mengubah pom.xml Anda sebagai berikut (Untuk Maven):
src/test/java **/*.java ...
Berikut ini adalah garis besar struktur umum Kerangka Kerja Karate:
Sekarang, karena Karate Framework ini menggunakan file Runner, yang juga dibutuhkan di Cucumber untuk menjalankan file fitur, maka sebagian besar penulisan akan mengikuti standar Cucumber.
Namun, tidak seperti Cucumber, langkah-langkahnya tidak memerlukan definisi yang jelas dalam Karate dan, pada gilirannya, meningkatkan fleksibilitas dan kemudahan pengoperasian. Kita tidak perlu menambahkan lem tambahan yang biasanya harus kita tambahkan ketika kita mengikuti kerangka kerja Cucumber.
Kelas "Pelari" sebagian besar dinamai TestRunner.java.
Kemudian file TestRunner.java akan berbentuk:
import com.intuit.karate.junit4.Karate; import org.junit.runner.RunWith; @RunWith(Karate.class) public class TestRunner { } Dan berbicara tentang .fitur berisi semua skenario pengujian yang perlu diuji untuk memastikan bahwa API berfungsi sesuai dengan persyaratan yang diharapkan.
File *.feature secara umum terlihat seperti yang ditunjukkan di bawah ini:
Fitur: mengambil Detail Pengguna Skenario: menguji pemanggilan get untuk Detail Pengguna Diberikan url '//reqres.in/api/users/2' When method GET Then status 200
Membuat Naskah Tes Karate Dasar Pertama
Bagian ini akan membantu Anda memulai pembuatan Test Script pertama Anda, yang akan sangat membantu Anda untuk mengonversi API dalam bentuk kerangka kerja Karate.
Sebelum kami menulis skrip tes Karate dasar, silakan instal persyaratan berikut di komputer Anda:
- Eclipse IDE
- Maven. Atur jalur Maven yang sesuai.
- JDK & JRE. Atur jalur yang sesuai.
Mari kita lihat pendekatan langkah demi langkah:
#1) Buat yang baru MAVEN Proyek di Editor Eclipse
- Buka Gerhana
- Klik File. Pilih Proyek Baru.
- Pilih Proyek Maven
- Pilih lokasi Ruang Kerja.
- Pilih Pola Dasar (biasanya kita memilih " Maven-archetype-quickstart 1.1 " untuk proyek-proyek Maven sederhana).
- Berikan ID Grup dan ID Artefak (kami telah menggunakan nilai berikut ini dalam contoh kami).
- ID Grup Karate
- ID Artefak: KarateTestScriptsSample
- Klik Finish untuk menyelesaikan penyiapan.
#2) Setelah dibuat, sekarang Anda akan dapat melihat struktur berikut di jendela Project Explorer.
#3) Sertakan semua Tanggungan Anda.
Langkah pertama kita, setelah penyiapan, kita akan melakukan menyertakan semua dependensi yang akan dibutuhkan untuk eksekusi. Kami akan menyimpan semua tag di bawah POM.xml (dengan asumsi Anda sudah mengetahui penggunaan POM.xml).
- Buka POM.xml dan salin kode di bawah ini di bawah tag ketergantungan dan simpan file tersebut.
com.intuit.karate karate-apache 0.9.5 test com.intuit.karate karate-junit4 0.9.5 test
Klik di sini untuk sumbernya.
#4) Mari kita curah pendapat tentang skenario, apa yang akan kita uji dalam Skrip Tes Dasar Karate ini.
Skenario:
Kami akan menguji API dengan URL ini.
Path: api/pengguna/2
Metode: DAPATKAN
Dan kita perlu memvalidasi , apakah permintaan tersebut mengembalikan sebuah Kode sukses (200) atau tidak.
Secara sederhana, kita hanya akan menguji sebuah contoh API untuk melihat apakah API tersebut berhasil dieksekusi atau tidak.
Catatan: Kami mengambil contoh API yang tersedia untuk pengujian. Anda dapat memilih PATH mana saja atau dapat merujuk ke API Anda.
Klik di sini untuk sumbernya.
#5) Sekarang langkah kita selanjutnya adalah membuat .fitur file.
Seperti yang telah dibahas di bagian pendahuluan, proses File .feature. adalah properti yang telah diwarisi dari Cucumber. Di dalam file ini, kita akan menuliskan skenario pengujian yang perlu dijalankan untuk melakukan API Testing.
- Pergi ke Folder src/test/java dalam proyek Anda.
- Klik Kanan di atasnya dan buat file baru - userDetails.feature. Kemudian klik tombol Selesai.
Sekarang Anda akan melihat file berikut di bawah folder src/test/java
The Ikon berwarna hijau menyerupai .feature fi le di Mentimun yang baru saja kita buat.
- Setelah file dibuat, sekarang kita akan menulis skenario pengujian yang akan dibahas di bagian berikut.
#6) Karena kita memiliki skenario dan blanko . fitur siap, sekarang mari kita mulai dengan skrip pertama kita. Mari kita mulai coding
Tuliskan baris kode berikut ini di bawah file userDetails.feature yang telah kita buat di Langkah #5:
Fitur: mengambil Detail Pengguna Skenario: menguji pemanggilan get untuk Detail Pengguna Diberikan url '//reqres.in/api/users/2' When method GET Then status 200
Mari kita coba memahami komponen yang tertulis dalam file di atas:
- Fitur: Kata kunci menjelaskan nama fitur yang sedang kita uji.
- Latar belakang: Ini adalah bagian opsional yang diperlakukan sebagai bagian Pra-syarat. Ini dapat digunakan untuk mendefinisikan apa saja yang diperlukan untuk menguji API. Ini berisi HEADER, URL & PARAM pilihan.
- Skenario: Setiap file fitur yang akan Anda lihat akan memiliki setidaknya satu fitur (meskipun dapat memberikan beberapa skenario), yaitu deskripsi kasus uji.
- Sudah: Ini adalah langkah yang harus dilakukan sebelum langkah pengujian lainnya dilakukan, dan merupakan tindakan yang wajib dilakukan.
- Kapan: Ini menentukan kondisi yang harus dipenuhi untuk melakukan langkah pengujian berikutnya.
- Kalau begitu: Ini memberi tahu kita bahwa apa yang harus terjadi jika kondisi yang disebutkan dalam Kapan puas.
Catatan: Semua kata kunci yang disebutkan di atas berasal dari bahasa Gherkins, yaitu cara standar untuk menulis skrip tes menggunakan Cucumber.
Dan beberapa kata lagi yang digunakan dalam file fitur adalah:
- 200: Ini adalah kode status/respon yang kami harapkan (Klik di sini untuk daftar kode status)
- DAPATKAN: Ini adalah metode API seperti POST, PUT, dll.
Kami harap penjelasan ini mudah untuk Anda pahami. Sekarang Anda akan dapat memahami apa yang sebenarnya tertulis dalam file di atas.
Sekarang kita perlu membuat file TestRunner.java
Seperti yang dijelaskan pada bagian di atas, Cucumber membutuhkan file Runner yang diperlukan untuk menjalankan .fitur yang berisi skenario pengujian.
- Pergi ke Folder src/test/java dalam proyek Anda
- Klik kanan di atasnya dan buat file Java baru: TestRunner.java
- Setelah file dibuat, letakkan baris kode berikut di bawahnya:
import org.junit.runner.RunWith; import com.intuit.karate.junit4.Karate; @RunWith(Karate.class) public class TestRunner { } - Test Runner adalah file yang sekarang akan dieksekusi untuk menjalankan skenario yang diinginkan yang telah ditulis pada Langkah #5.
#7) Sekarang kita sudah siap dengan kedua file tersebut TestRunner.Java dan userDeatils.feature. Satu-satunya tugas yang tersisa bagi kita adalah untuk Jalankan naskahnya.
- Buka file TestRunner.java dan klik kanan pada file tersebut seperti yang ditunjukkan pada gambar di bawah ini.
- Pilih Jalankan Sebagai - & gt; Tes Junit
- Sekarang, setelah dipilih, Anda akan mulai mengamati bahwa kasus uji sekarang telah dimulai.
- Tunggu hingga skrip pengujian dijalankan. Setelah selesai, Anda akan melihat sesuatu seperti yang ditunjukkan pada gambar di bawah ini di jendela Anda.
- Akhirnya, kami dapat mengatakan bahwa kami telah berhasil menciptakan dasar pertama kami Skrip Tes menggunakan Kerangka Kerja Karate.
#8) Terakhir, kerangka kerja Karate juga memberikan presentasi laporan HTML untuk eksekusi yang telah dilakukan.
- Buka Folder Target -> surefire-reports-> Di sini Anda akan melihat laporan HTML Anda yang dapat Anda buka.
** Kami juga menyarankan Anda untuk membuka halaman yang sama menggunakan Browser Chrome untuk tampilan dan nuansa yang lebih baik.
- Laporan HTML berikut akan ditampilkan kepada Anda yang menggambarkan Skenario & Tes yang telah dijalankan untuk skenario yang disebutkan:
Kesimpulan
Dalam tutorial ini, kita telah membahas pengujian API, berbagai alat pengujian yang tersedia di pasar, dan bagaimana Karate Framework merupakan pilihan yang lebih baik dibandingkan dengan rekan-rekannya.
Kami mengikuti pendekatan langkah demi langkah untuk membuat skrip pengujian dasar pertama kami. Kami mulai dengan membuat Proyek Maven di Eclipse IDE untuk membuat file .feature, yang berisi semua skenario pengujian dan file Runner untuk menjalankan kasus uji yang disebutkan dalam file .feature.
Pada akhir dari beberapa langkah, kita bisa melihat laporan eksekusi dari hasil pengujian.
Kami berharap, tutorial ini bermanfaat bagi para pemula dalam mempelajari cara membuat skrip pengujian pertama mereka menggunakan Karate Framework dan melakukan Pengujian API. Pendekatan langkah demi langkah yang mendetail ini merupakan cara yang luar biasa untuk menjalankan dan menjalankan berbagai macam pengujian pada API.
SELANJUTNYA & gt; & gt;