Référence rapide

Aide-mémoire RSpec Rails

Un guide de référence rapide pour rspec-rails : specs de modèles, requêtes, système, routes et transactions en base de données.

· Publié le

rspec-rails intègre le framework de test RSpec dans Ruby on Rails.

Installation et configuration

Ajouter au Gemfile :

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

Initialiser les répertoires de specs :

bin/rails generate rspec:install

Specs de modèles (spec/models/)

require 'rails_helper'

RSpec.describe User, type: :model do
  it "is valid with valid attributes" do
    user = User.new(name: "Alice", email: "[email protected]")
    expect(user).to be_valid
  end

  it "is invalid without an email" do
    user = User.new(name: "Alice", email: nil)
    expect(user).not_to be_valid
    expect(user.errors[:email]).to include("can't be blank")
  end
end

Specs de requêtes (spec/requests/)

Les specs de requête testent des cycles de requêtes HTTP complets :

require 'rails_helper'

RSpec.describe "Articles API", type: :request do
  describe "GET /articles" do
    it "returns HTTP success and lists articles" do
      get "/articles", headers: { "Accept" => "application/json" }

      expect(response).to have_http_status(:ok)
      json = JSON.parse(response.body)
      expect(json).to be_an(Array)
    end
  end
end

Specs système avec Capybara

require 'rails_helper'

RSpec.describe "User Login", type: :system do
  before do
    driven_by(:selenium_chrome_headless)
  end

  it "allows user to sign in" do
    visit login_path
    fill_in "Email", with: "[email protected]"
    fill_in "Password", with: "secret123"
    click_button "Sign in"

    expect(page).to have_content("Welcome back!")
  end
end

Références

Sujets associés