Ming. Nov 22nd, 2026

Panduan Langkah demi Langkah: Menulis Unit Test Ruby on Rails

Meja developer dengan laptop menampilkan kode dan hasil pengujian unit test Ruby on Rails

Unit test adalah pengujian yang memeriksa satu bagian kecil kode secara terpisah, biasanya sebuah method atau class. Di Ruby on Rails, unit test paling sering dipakai untuk menguji model dan service object. Tulisan ini memandu kamu menulis unit test dari nol, mulai dari menyiapkan RSpec hingga menguji logika yang rumit.

Kenapa unit test perlu ditulis lebih dulu

Menulis unit test sebelum atau sesudah kode sama-sama boleh. Yang penting, pengujian ini fokus pada satu unit kerja dan tidak menyentuh database atau jaringan jika tidak perlu. Dengan begitu, test berjalan cepat dan mudah dilacak saat gagal.

Banyak tim memulai dari integration test karena lebih terasa hasilnya. Namun, unit test membantu kamu mengunci perilaku method tertentu, terutama yang punya banyak cabang logika. Jika ingin memperkuat kebiasaan ini, lihat juga kebiasaan ngoding Ruby on Rails yang bikin proyek awet.

Langkah 1: Siapkan RSpec dan struktur folder

Rails default memakai Minitest. Untuk panduan ini, kita pakai RSpec karena sintaksnya mudah dibaca. Tambahkan rspec-rails di Gemfile grup development dan test, lalu jalankan generator.

group :development, :test do
  gem 'rspec-rails'
end

Setelah bundle install, jalankan perintah rails generate rspec:install. Perintah ini membuat folder spec/ berisi rails_helper.rb dan spec_helper.rb. Folder spec/models dan spec/services biasanya dibuat manual atau lewat generator saat membuat file baru.

Langkah 2: Tulis test pertama untuk model

Mulai dari model yang sederhana. Misalnya model Article dengan atribut title dan body. Buat file spec/models/article_spec.rb, lalu tulis skenario validasi.

require 'rails_helper'

RSpec.describe Article, type: :model do
  it 'valid dengan title dan body' do
    article = Article.new(title: 'Halo', body: 'Isi')
    expect(article).to be_valid
  end

  it 'tidak valid tanpa title' do
    article = Article.new(body: 'Isi')
    expect(article).to_not be_valid
  end
end

Jalankan bundle exec rspec spec/models/article_spec.rb. Jika test gagal, baca pesan error dengan saksama. Sering kali masalahnya bukan di kode aplikasi, melainkan di data uji yang belum lengkap.

Langkah 3: Isolasi database denganFactoryBot

Membuat data langsung di setiap test membuat kode berulang dan sulit dirawat. FactoryBot menyediakan cara ringkas untuk membuat data uji. Tambahkan gem factory_bot_rails, lalu buat file spec/factories/articles.rb.

FactoryBot.define do
  factory :article do
    title { 'Judul contoh' }
    body { 'Isi contoh' }
  end
end

Di dalam test, cukup panggil build(:article) untuk objek tanpa simpan ke database, atau create(:article) jika butuh record tersimpan. Manfaatkan trait untuk variasi data, misalnya artikel tanpa body. Jika kamu baru mulai belajar Rails, panduan awal untuk pemula bisa jadi titik berangkat yang pas.

Langkah 4: Uji service object dengan logika bercabang

Service object sering menyimpan aturan bisnis yang tidak pas ditaruh di model. Contohnya ArticlePublisher yang memutuskan apakah artikel boleh terbit berdasarkan status dan jumlah kata. Karena tidak bergantung pada request HTTP, service cocok diuji dengan unit test.

require 'rails_helper'

RSpec.describe ArticlePublisher do
  it 'menerbitkan artikel yang memenuhi syarat' do
    article = build(:article, body: 'kata ' * 300)
    result = described_class.new(article).call
    expect(result).to be_success
  end

  it 'menolak artikel yang terlalu pendek' do
    article = build(:article, body: 'pendek')
    result = described_class.new(article).call
    expect(result).to_not be_success
    expect(result.error).to eq('body terlalu pendek')
  end
end

Perhatikan bahwa test di atas memakai build, bukan create. Dengan begitu, test tidak menyentuh database sama sekali dan berjalan lebih cepat. Untuk logika yang lebih rumit, pecah service menjadi method kecil yang masing-masing bisa diuji terpisah.

Langkah 5: Tangani dependensi dengan stub dan mock

Unit test sebaiknya tidak memanggil layanan eksternal seperti API pembayaran atau pengiriman email. Gunakan stub untuk mengganti perilaku tersebut. RSpec menyediakan allow dan instance_double untuk keperluan ini.

it 'mengirim notifikasi setelah artikel terbit' do
  notifier = instance_double(ArticleNotifier, deliver: true)
  allow(ArticleNotifier).to receive(:new).and_return(notifier)

  article = build(:article, body: 'kata ' * 300)
  ArticlePublisher.new(article).call

  expect(notifier).to have_received(:deliver)
end

Stub membuat test tetap fokus pada unit yang diuji. Namun, jangan berlebihan. Jika terlalu banyak stub, mungkin ada ketergantungan yang perlu dipecah. Jika kamu memakai Action Mailer, pengujian pengiriman email bisa dilakukan terpisah dengan panduan Action Mailer.

Langkah 6: Jalankan test secara rutin dan ukur cakupan

Jalankan bundle exec rspec setiap kali selesai menambah fitur. Biasakan juga menjalankan test sebelum commit. Untuk melihat seberapa banyak kode yang sudah diuji, tambahkan gem simplecov dan panggil di rails_helper.rb.

require 'simplecov'
SimpleCov.start 'rails'

Angka cakupan bukan tujuan akhir, tapi berguna untuk menemukan file yang sama sekali belum disentuh test. Fokuslah pada logika yang sering berubah dan berisiko tinggi, bukan mengejar 100 persen.

Menulis unit test bukan pekerjaan sekali jadi. Saat kode berubah, test juga perlu diperbarui. Jika test mulai sulit dirawat, mungkin saatnya merapikan kode terlebih dahulu. Ada langkah refactor kode Rails yang berantakan yang bisa kamu ikuti agar test lebih mudah ditulis. Untuk tugas-tugas web yang lebih luas, kamu bisa melihat perbandingan memilih PHP, JavaScript, dan CSS untuk tugas web sebagai bahan pertimbangan.

Ringkasan

Unit test Ruby on Rails paling efektif jika dimulai dari model sederhana, dilanjutkan ke service object, dan dibantu FactoryBot serta stub untuk dependensi. Jalankan test secara rutin dan pantau cakupan seadanya. Dengan begitu, bug bisa ditemukan lebih awal tanpa harus menjalankan seluruh aplikasi.

Pertanyaan yang Sering Diajukan

Apakah unit test harus selalu menggunakan database?

Tidak. Model yang tidak membutuhkan query cukup diuji dengan build dan validasi di memori. Database baru diperlukan saat test benar-benar memeriksa query atau callback yang menyentuh penyimpanan.

Berapa banyak unit test yang ideal untuk satu method?

Tidak ada angka pasti. Fokuslah pada cabang logika dan kasus batas. Jika method punya tiga kemungkinan hasil, minimal ada tiga test yang mewakili masing-masing hasil.

Apakah unit test bisa menggantikan integration test?

Tidak. Unit test memeriksa bagian kecil secara terisolasi, sedangkan integration test memastikan alur antar komponen berjalan. Keduanya saling melengkapi dan sebaiknya dijalankan bersama.

Ingin menonton pertandingan basket, sepakbola, atau UFC bareng host yang menghibur? Ada tarkamlive yang menyediakan nobar gratis dengan gaya santai.

Untuk informasi berita yang bisa diandalkan, kunjungi indowarta. Situs ini menyajikan berita berdasarkan fakta dengan penulis berpengalaman, bukan opini sepihak.

Related Post