Rails 5 Test Prescriptions 第8章 Integration Testing with Capybara and Cucumber

Capybara:  A complete reference is available atrubydoc.info.

集成测试就是把局部的程序组合起来测试。

端到端测试是一个特殊的集成测试，覆盖了系统的全部行为, end-to-end.

接受测试acceptance test是用来指定正确行为，从客户或商业想法出发。Acceptance tests 通常在代码开始之前就计划或者写了。

集成测试也使用Javascript driver来评测基于Javascript的模仿用户行动。

本章是无Js版本，下章是有Js版本。

• Setting up Capybara✅
• Using Feature Tests to bulid a Feature✅
• What to Test in an RSpec System test✅
• Outside-in Testing
• Making the Capybara Test Pass
• Retrospective回顾
• Setting up Cucumber ⚠️新的知识点，概览！！
• Writing Cucumber Features
• Writing Cucumber Steps
• Advanced Cucumber
• is Cucumber Worth it?

---

A Field Guide to Integration and System Tests

Rails core testing library defines two similar types of end-to-end test:

integration test:传统的Rails测试，使用自己的API,功能没Capybara强大。

system test:5.1新增的。需要使用Capybara 。也叫feature tests. 也可以叫integration test。

另外Request 测试，是指URL for routing的test input。也是integration的一种。（11章会学习 request specs.）

RSpec-rails团队，推荐使用Capybara在系统测试中，不论是否使用JavaScript。

---

Setting Up Capybara  (API  doucument)

使用自己的API来和元素交互，使用驱动来管理实际的交互。默认不提供Js 交互，但可以配置使用一个无头的浏览器,如headless Chrome让JS交互被模仿。

gem "capybara-screenshot"用来闪存测试失败 （800星）放在support/system.rb

RSpec.configure do |config|

  config.before(:each, type: :system) do

    driven_by :rack_test

  end

end

require "capybara-screenshot/rspec" 

---

Using Feature Tests to Build a Feature

Writing a test

Given: 一个project ，2个task.

When/then: 用户填写form，你确认新的task建立

When/then：用户移动一个task up向上（增加向上和向下的按钮，task的排列？），你确认顺序改变。

system/add_tasks_spec.rb

⚠️ RSpec有rspec:feature生成器。

RSpec.describe "adding a new task" do

# given 3 data

  let!(:project) { create(:project, name: "Project Bluebook") }

  let!(:task_1) { create(

    :task, project: project, title: "Search Sky", size: 1) }

  let!(:task_2) { create(

    :task, project: project, title: "Use Telescope", size: 1) }

  it "can add and reorder a task" do

# when/then1:

    visit project_path(project)

    fill_in("Task", with:"Find UFOS")

    select("2", from: "Size")

    click_on("Add Task")

    expect(current_path).to eq(project_path(project))

    within("#task_3") do

      expect(page).to have_selector(".name", text: "Find UFOS")

      expect(page).to have_selector(".size", text: "2")

      expect(page).not_to have_selector("a", text: "Down")

# when/then2:

      click_on("Up")

    end

    expect(current_path).to eq(project_path(project))

    within('#task_2') do

      expect(page).to have_selector(".name", text: "Find UFOS")

    end

  end

end

 

The Capybara API: Navigating 

vist 对应 HTTP GET方法，

click_on(link/button)对应  HTTP POST方法

expect(page).to have_current_path(project_path(project))

⚠️最好