測試 Rails 應用程式

$ ls -F test
application_system_test_case.rb  controllers/                     helpers/                         mailers/                         system/
channels/                        fixtures/                        integration/                     models/                          test_helper.rb

$ bin/rails generate model article title:string body:text
...
create  app/models/article.rb
create  test/models/article_test.rb
create  test/fixtures/articles.yml
...

require "test_helper"

class ArticleTest < ActiveSupport::TestCase
  # test "the truth" do
  #   assert true
  # end
end

require "test_helper"

class ArticleTest < ActiveSupport::TestCase

test "the truth" do
  assert true
end

斷言 真

test "應該沒有標題時無法保存文章" do
  文章 = Article.new
  斷言_不是 文章.save
end

$ bin/rails test test/models/article_test.rb:6
運行選項: --seed 44656

# 運行中:

F

失敗:
ArticleTest#test_should_not_save_article_without_title [/path/to/blog/test/models/article_test.rb:6]:
預期為true，但實際為nil或false


bin/rails test test/models/article_test.rb:6



完成於 0.023918s，41.8090 次運行/秒，41.8090 斷言/秒。

1 次運行，1 斷言，1 失敗，0 錯誤，0 跳過

test "應該沒有標題時無法保存文章" do
  文章 = Article.new
  斷言_不是 文章.save, "保存了沒有標題的文章"
end

失敗:
ArticleTest#test_should_not_save_article_without_title [/path/to/blog/test/models/article_test.rb:6]:
保存了沒有標題的文章

class Article < ApplicationRecord
  validates :title, presence: true
end

$ bin/rails test test/models/article_test.rb:6
運行選項: --seed 31252

# 運行中:

.

完成於 0.027476s，36.3952 次運行/秒，36.3952 斷言/秒。

1 次運行，1 斷言，0 失敗，0 錯誤，0 跳過

test "應該報告錯誤" do
  # some_undefined_variable在測試用例中未定義
  some_undefined_variable
  斷言 真
end

$ bin/rails test test/models/article_test.rb
運行選項: --seed 1808

# 運行中:

.E

錯誤:
ArticleTest#test_should_report_error:
NameError: undefined local variable or method 'some_undefined_variable' for #<ArticleTest:0x007fee3aa71798>
    test/models/article_test.rb:11:in 'block in <class:ArticleTest>'


bin/rails test test/models/article_test.rb:9



完成於 0.040609s，49.2500 次運行/秒，24.6250 斷言/秒。

2 次運行，1 斷言，0 失敗，1 錯誤，0 跳過

test "應該報錯" do
  # some_undefined_variable 在測試案例中未定義
  assert_raises(NameError) do
    some_undefined_variable
  end
end

$ bin/rails test test/models/article_test.rb
Run options: --seed 1559

# Running:

..

Finished in 0.027034s, 73.9810 runs/s, 110.9715 assertions/s.

2 runs, 3 assertions, 0 failures, 0 errors, 0 skips

$ bin/rails test test/models/article_test.rb -n test_the_truth
Run options: -n test_the_truth --seed 43583

# Running:

.

Finished tests in 0.009064s, 110.3266 tests/s, 110.3266 assertions/s.

1 tests, 1 assertions, 0 failures, 0 errors, 0 skips

$ bin/rails test test/models/article_test.rb:6 # 運行特定的測試和行號

$ bin/rails test test/controllers # 運行特定目錄中的所有測試

$ bin/rails test -h
Usage: rails test [options] [files or directories]

You can run a single test by appending a line number to a filename:

    bin/rails test test/models/user_test.rb:27

You can run multiple files and directories at the same time:

    bin/rails test test/controllers test/integration/login_test.rb

By default test failures and errors are reported inline during a run.

minitest options:
    -h, --help                       Display this help.
        --no-plugins                 Bypass minitest plugin auto-loading (or set $MT_NO_PLUGINS).
    -s, --seed SEED                  Sets random seed. Also via env. Eg: SEED=n rake
    -v, --verbose                    Verbose. Show progress processing files.
    -n, --name PATTERN               Filter run on /regexp/ or string.
        --exclude PATTERN            Exclude /regexp/ or string from run.

Known extensions: rails, pride
    -w, --warnings                   Run with Ruby warnings enabled
    -e, --environment ENV            Run tests in the ENV environment
    -b, --backtrace                  Show the complete backtrace
    -d, --defer-output               Output test failures and errors after the test run
    -f, --fail-fast                  Abort test run on first failure or error
    -c, --[no-]color                 Enable color in the output
    -p, --pride                      Pride. Show your testing pride!

$ bin/rails test

class ActiveSupport::TestCase
  parallelize(workers: 2)
end

$ PARALLEL_WORKERS=15 bin/rails test

class ActiveSupport::TestCase
  parallelize_setup do |worker|
    # 設置數據庫
  end

  parallelize_teardown do |worker|
    # 清理數據庫
  end

  parallelize(workers: :number_of_processors)
end

class ActiveSupport::TestCase
  parallelize(workers: :number_of_processors, with: :threads)
end

$ PARALLEL_WORKERS=15 bin/rails test

class WorkerTest < ActiveSupport::TestCase
  self.use_transactional_tests = false

  test "parallel transactions" do
    # 啟動一些創建事務的線程
  end
end

class ActiveSupport::TestCase
  parallelize threshold: 100
end

# lo & behold! I am a YAML comment!
david:
  name: David Heinemeier Hansson
  birthday: 1979-10-15
  profession: Systems development

steve:
  name: Steve Ross Kellock
  birthday: 1974-09-27
  profession: guy with keyboard

# test/fixtures/categories.yml
about:
  name: About

# test/fixtures/articles.yml
first:
  title: Welcome to Rails!
  category: about

# test/fixtures/action_text/rich_texts.yml
first_content:
  record: first (Article)
  name: content
  body: <div>Hello, from <strong>a fixture</strong></div>

class Article
  has_one_attached :thumbnail
end

# test/fixtures/articles.yml
first:
  title: An Article

# test/fixtures/active_storage/blobs.yml
first_thumbnail_blob: <%= ActiveStorage::FixtureSet.blob filename: "first.png" %>

# test/fixtures/active_storage/attachments.yml
first_thumbnail_attachment:
  name: thumbnail
  record: first (Article)
  blob: first_thumbnail_blob

<% 1000.times do |n| %>
user_<%= n %>:
  username: <%= "user#{n}" %>
  email: <%= "user#{n}@example.com" %>
<% end %>

# 這將返回名為david的夾具的User對象
users(:david)

# 這將返回名為david的屬性的id
users(:david).id

# 也可以訪問User類上可用的方法
david = users(:david)
david.call(david.partner)

# 這將返回包含夾具david和steve的數組
users(:david, :steve)

$ bin/rails generate test_unit:model article title:string body:text
create  test/models/article_test.rb
create  test/fixtures/articles.yml

$ bin/rails generate system_test users
      invoke test_unit
      create test/system/users_test.rb

require "application_system_test_case"

class UsersTest < ApplicationSystemTestCase
  # test "visiting the index" do
  #   visit users_url
  #
  #   assert_selector "h1", text: "Users"
  # end
end

require "test_helper"
require "capybara/cuprite"

class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
  driven_by :cuprite
end

require "test_helper"

class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
  driven_by :selenium, using: :headless_chrome
end

require "test_helper"

class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
  options = ENV["SELENIUM_REMOTE_URL"].present? ? { url: ENV["SELENIUM_REMOTE_URL"] } : {}
  driven_by :selenium, using: :headless_chrome, options: options
end

# ...
group :test do
  gem "webdrivers", require: !ENV["SELENIUM_REMOTE_URL"] || ENV["SELENIUM_REMOTE_URL"].empty?
end

$ SELENIUM_REMOTE_URL=http://localhost:4444/wd/hub bin/rails test:system

require "test_helper"

class ApplicationSystemTestCase < ActionDispatch::SystemTestCase
  def setup
    Capybara.server_host = "0.0.0.0" # 綁定到所有接口
    Capybara.app_host = "http://#{IPSocket.getaddress(Socket.gethostname)}" if ENV["SELENIUM_REMOTE_URL"].present?
    super
  end
  # ...
end

$ bin/rails generate system_test articles

      invoke  test_unit
      create    test/system/articles_test.rb

require "application_system_test_case"

class ArticlesTest < ApplicationSystemTestCase
  test "viewing the index" do
    visit articles_path
    assert_selector "h1", text: "Articles"
  end
end

$ bin/rails test:system

test "should create Article" do
  visit articles_path

  click_on "New Article"

  fill_in "Title", with: "Creating an Article"
  fill_in "Body", with: "Created this article successfully!"

  click_on "Create Article"

  assert_text "Creating an Article"
end

require "mobile_system_test_case"

class PostsTest < MobileSystemTestCase
  test "訪問首頁" do
    visit posts_url
    assert_selector "h1", text: "Posts"
  end
end

$ bin/rails generate integration_test user_flows
      exists  test/integration/
      create  test/integration/user_flows_test.rb

require "test_helper"

class UserFlowsTest < ActionDispatch::IntegrationTest
  # test "the truth" do
  #   assert true
  # end
end

$ bin/rails generate integration_test blog_flow

      invoke  test_unit
      create    test/integration/blog_flow_test.rb

require "test_helper"

class BlogFlowTest < ActionDispatch::IntegrationTest
  test "可以看到歡迎頁面" do
    get "/"
    assert_select "h1", "Welcome#index"
  end
end

test "可以創建一篇文章" do
  get "/articles/new"
  assert_response :success

  post "/articles",
    params: { article: { title: "可以創建", body: "成功創建文章。" } }
  assert_response :redirect
  follow_redirect!
  assert_response :success
  assert_select "p", "標題:\n  可以創建"
end

post "/articles",
  params: { article: { title: "可以創建", body: "成功創建文章。" } }
assert_response :redirect
follow_redirect!

$ bin/rails generate scaffold_controller article title:string body:text
...
create  app/controllers/articles_controller.rb
...
invoke  test_unit
create    test/controllers/articles_controller_test.rb
...

$ bin/rails generate test_unit:scaffold article
...
invoke  test_unit
create    test/controllers/articles_controller_test.rb
...

# articles_controller_test.rb
class ArticlesControllerTest < ActionDispatch::IntegrationTest
  test "should get index" do
    get articles_url
    assert_response :success
  end
end

get article_url(Article.first), headers: { "HTTP_REFERER" => "http://example.com/home" }

patch article_url(Article.last), params: { article: { title: "updated" } }, xhr: true

post articles_path, params: { article: { title: "Ahoy!" } }, as: :json

test "should create article" do
  assert_difference("Article.count") do
    post articles_url, params: { article: { body: "Rails is awesome!", title: "Hello Rails" } }
  end

  assert_redirected_to article_path(Article.last)
end

post articles_url, params: { article: { body: "Rails is awesome!", title: "Hello Rails" } }, headers: { Authorization: ActionController::HttpAuthentication::Basic.encode_credentials("dhh", "secret") }

test "ajax request" do
  article = articles(:one)
  get article_url(article), xhr: true

  assert_equal "hello world", @response.body
  assert_equal "text/javascript", @response.media_type
end

flash["gordon"]               flash[:gordon]
session["shmession"]          session[:shmession]
cookies["are_good_for_u"]     cookies[:are_good_for_u]

class ArticlesControllerTest < ActionDispatch::IntegrationTest
  test "should get index" do
    get articles_url

    assert_equal "index", @controller.action_name
    assert_equal "application/x-www-form-urlencoded", @request.media_type
    assert_match "Articles", @response.body
  end
end

# 設置 HTTP 標頭
get articles_url, headers: { "Content-Type": "text/plain" } # 模擬帶有自定義標頭的請求

# 設置 CGI 變量
get articles_url, headers: { "HTTP_REFERER": "http://example.com/home" } # 模擬帶有自定義環境變量的請求

test "should create article" do
  assert_difference("Article.count") do
    post articles_url, params: { article: { title: "Some title" } }
  end

  assert_redirected_to article_path(Article.last)
  assert_equal "Article was successfully created.", flash[:notice]
end

$ bin/rails test test/controllers/articles_controller_test.rb -n test_should_create_article
Run options: -n test_should_create_article --seed 32266

# Running:

F

Finished in 0.114870s, 8.7055 runs/s, 34.8220 assertions/s.

  1) Failure:
ArticlesControllerTest#test_should_create_article [/test/controllers/articles_controller_test.rb:16]:
--- expected
+++ actual
@@ -1 +1 @@
-"Article was successfully created."
+nil

1 runs, 4 assertions, 1 failures, 0 errors, 0 skips

def create
  @article = Article.new(article_params)

  if @article.save
    flash[:notice] = "Article was successfully created."
    redirect_to @article
  else
    render "new"
  end
end

$ bin/rails test test/controllers/articles_controller_test.rb -n test_should_create_article
Run options: -n test_should_create_article --seed 18981

# Running:

.

Finished in 0.081972s, 12.1993 runs/s, 48.7972 assertions/s.

1 runs, 4 assertions, 0 failures, 0 errors, 0 skips

test "should show article" do
  article = articles(:one)
  get article_url(article)
  assert_response :success
end

test "should destroy article" do
  article = articles(:one)
  assert_difference("Article.count", -1) do
    delete article_url(article)
  end

  assert_redirected_to articles_path
end

test "should update article" do
  article = articles(:one)

  patch article_url(article), params: { article: { title: "updated" } }

  assert_redirected_to article_path(article)
  # 重新加載關聯以獲取更新的數據並斷言標題已更新。
  article.reload
  assert_equal "updated", article.title
end

assert_redirected_to articles_path

assert_redirected_to article_path(@article)
# 重新加載關聯以獲取更新的數據並斷言標題已更新
@article.reload
assert_equal "updated", @article.title

# test/test_helper.rb

module SignInHelper
  def sign_in_as(user)
    post sign_in_url(email: user.email, password: user.password)
  end
end

class ActionDispatch::IntegrationTest
  include SignInHelper
end

require "test_helper"

class ProfileControllerTest < ActionDispatch::IntegrationTest
  test "應該顯示個人資料" do
    # 現在助手可以在任何控制器測試案例中重複使用
    sign_in_as users(:david)

    get profile_url
    assert_response :success
  end
end

# test/test_helpers/multiple_assertions.rb
module MultipleAssertions
  def assert_multiple_of_forty_two(number)
    assert (number % 42 == 0), "expected #{number} to be a multiple of 42"
  end
end

require "test_helper"
require "test_helpers/multiple_assertions"

class NumberTest < ActiveSupport::TestCase
  include MultipleAssertions

  test "420 是 42 的倍數" do
    assert_multiple_of_forty_two 420
  end
end

# test/test_helper.rb
require "test_helpers/sign_in_helper"

class ActionDispatch::IntegrationTest
  include SignInHelper
end

# test/test_helper.rb
Dir[Rails.root.join("test", "test_helpers", "**", "*.rb")].each { |file| require file }

assert_select "title", "歡迎來到 Rails 測試指南"

assert_select "ul.navigation" do
  assert_select "li.menu_item"
end

assert_select "ol" do |elements|
  elements.each do |element|
    assert_select element, "li", 4
  end
end

assert_select "ol" do
  assert_select "li", 8
end

assert_select_email do
  assert_select "small", "Please click the 'Unsubscribe' link if you want to opt-out."
end

module UsersHelper
  def link_to_user(user)
    link_to "#{user.first_name} #{user.last_name}", user
  end
end

class UsersHelperTest < ActionView::TestCase
  test "should return the user's full name" do
    user = users(:david)

    assert_dom_equal %{<a href="/user/#{user.id}">David Heinemeier Hansson</a>}, link_to_user(user)
  end
end

require "test_helper"

class UserMailerTest < ActionMailer::TestCase
  test "invite" do
    # 創建郵件並將其存儲以進行進一步的斷言
    email = UserMailer.create_invite("[email protected]",
                                     "[email protected]", Time.now)

    # 發送郵件，然後測試它是否被排隊
    assert_emails 1 do
      email.deliver_now
    end

    # 測試發送的郵件正文是否包含我們期望的內容
    assert_equal ["[email protected]"], email.from
    assert_equal ["[email protected]"], email.to
    assert_equal "You have been invited by [email protected]", email.subject
    assert_equal read_fixture("invite").join, email.body.to_s
  end
end

Hi [email protected],

You have been invited.

Cheers!

require "test_helper"

class UserMailerTest < ActionMailer::TestCase
  test "invite" do
    # 創建郵件並將其存儲以進行進一步的斷言
    email = UserMailer.create_invite("[email protected]", "[email protected]")

    # 測試郵件是否已使用正確的參數排隊
    assert_enqueued_email_with UserMailer, :create_invite, args: ["[email protected]", "[email protected]"] do
      email.deliver_later
    end
  end
end

require "test_helper"

class UserMailerTest < ActionMailer::TestCase
  test "invite" do
    # 創建郵件並將其存儲以進行進一步的斷言
    email = UserMailer.create_invite(from: "[email protected]", to: "[email protected]")

    # 測試郵件是否已使用正確的命名參數排隊
    assert_enqueued_email_with UserMailer, :create_invite, args: [{ from: "[email protected]",
                                                                    to: "[email protected]" }] do
      email.deliver_later
    end
  end
end

require "test_helper"

class UserMailerTest < ActionMailer::TestCase
  test "invite" do
    # 創建郵件並將其存儲以進行進一步的斷言
    email = UserMailer.with(all: "good").create_invite("[email protected]", "[email protected]")

    # 測試郵件是否已使用正確的郵件參數和參數排隊
    assert_enqueued_email_with UserMailer, :create_invite, params: { all: "good" },
                                                           args: ["[email protected]", "[email protected]"] do
      email.deliver_later
    end
  end
end

require "test_helper"

class UserMailerTest < ActionMailer::TestCase
  test "invite" do
    # 創建郵件並將其存儲以進行進一步的斷言
    email = UserMailer.with(to: "[email protected]").create_invite

    # 測試郵件是否已使用正確的郵件參數排隊
    assert_enqueued_email_with UserMailer.with(to: "[email protected]"), :create_invite do
      email.deliver_later
    end
  end
end

# 整合測試
require "test_helper"

class UsersControllerTest < ActionDispatch::IntegrationTest
  test "invite friend" do
    # 斷言 ActionMailer::Base.deliveries 的差異
    assert_emails 1 do
      post invite_friend_url, params: { email: "[email protected]" }
    end
  end
end

# 系統測試
require "test_helper"

class UsersTest < ActionDispatch::SystemTestCase
  driven_by :selenium, using: :headless_chrome

  test "inviting a friend" do
    visit invite_users_url
    fill_in "Email", with: "[email protected]"
    assert_emails 1 do
      click_on "Invite"
    end
  end
end

require "test_helper"

class BillingJobTest < ActiveJob::TestCase
  test "帳戶被扣款" do
    BillingJob.perform_now(account, product)
    assert account.reload.charged_for?(product)
  end
end

require "test_helper"

class ProductTest < ActiveSupport::TestCase
  include ActiveJob::TestHelper

  test "計費工作排程" do
    assert_enqueued_with(job: BillingJob) do
      product.charge(account)
    end
    assert_not account.reload.charged_for?(product)
  end
end

require "test_helper"

class ProductTest < ActiveSupport::TestCase
  include ActiveJob::TestHelper

  test "計費工作排程" do
    perform_enqueued_jobs(only: BillingJob) do
      product.charge(account)
    end
    assert account.reload.charged_for?(product)
  end
end

class ApplicationCable::ConnectionTest < ActionCable::Connection::TestCase
  test "帶參數連接" do
    # 通過調用`connect`方法來模擬連接打開
    connect params: { user_id: 42 }

    # 您可以通過測試中的`connection`訪問Connection對象
    assert_equal connection.user_id, "42"
  end

  test "拒絕不帶參數的連接" do
    # 使用`assert_reject_connection`匹配器來驗證連接是否被拒絕
    assert_reject_connection { connect }
  end
end

test "帶cookie連接" do
  cookies.signed[:user_id] = "42"

  connect

  assert_equal connection.user_id, "42"
end

require "test_helper"

class ChatChannelTest < ActionCable::Channel::TestCase
  test "訂閱並為房間流" do
    # 通過調用`subscribe`來模擬訂閱創建
    subscribe room: "15"

    # 您可以通過測試中的`subscription`訪問Channel對象
    assert subscription.confirmed?
    assert_has_stream "chat_15"
  end
end

require "test_helper"

class WebNotificationsChannelTest < ActionCable::Channel::TestCase
  test "訂閱並為用戶流" do
    stub_connection current_user: users(:john)

    subscribe

    assert_has_stream_for users(:john)
  end
end

# app/jobs/chat_relay_job.rb
class ChatRelayJob < ApplicationJob
  def perform(room, message)
    ChatChannel.broadcast_to room, text: message
  end
end

# test/jobs/chat_relay_job_test.rb
require "test_helper"

class ChatRelayJobTest < ActiveJob::TestCase
  include ActionCable::TestHelper

  test "廣播訊息到房間" do
    room = rooms(:all)

    assert_broadcast_on(ChatChannel.broadcasting_for(room), text: "Hi!") do
      ChatRelayJob.perform_now(room, "Hi!")
    end
  end
end

# config/environments/test.rb
config.eager_load = ENV["CI"].present?

require "test_helper"

class ZeitwerkComplianceTest < ActiveSupport::TestCase
  test "eager load 所有檔案並無錯誤" do
    assert_nothing_raised { Rails.application.eager_load! }
  end
end

require "rails_helper"

RSpec.describe "Zeitwerk compliance" do
  it "eager load 所有檔案並無錯誤" do
    expect { Rails.application.eager_load! }.not_to raise_error
  end
end

# 假設使用者在註冊後一個月才有資格贈送。
user = User.create(name: "Gaurish", activation_date: Date.new(2004, 10, 24))
assert_not user.applicable_for_gifting?

travel_to Date.new(2004, 11, 24) do
  # 在 `travel_to` 區塊內，`Date.current` 被 stub
  assert_equal Date.new(2004, 10, 24), user.activation_date
  assert user.applicable_for_gifting?
end

# 這個變化只在 `travel_to` 區塊內可見。
assert_equal Date.new(2004, 10, 24), user.activation_date