我本来打算向您介绍在线文档,但我所知道的在线文档(at cucumber.io 和 at relishapp.com)实际上并不能很好地回答您的问题。 (不过,它确实包含许多示例,非常值得一读。)
在 Cucumber 的 Ruby 实现中,步骤定义文件是features/step_definition 目录中的.rb 文件。它们包含一系列对方法的调用,每个方法都定义了 Gherkin 步骤的实现。这是一个例子:
Given /^there is a user named "(.*)"$/ do |username|
# code that creates a user with the given username
end
定义步骤的方法有多种:Given、When、Then、And 和 But。它们都做完全相同的事情,您可以使用任何一个来定义任何步骤。最佳做法是使用最适合您定义的步骤的那个(不要使用And 或But)。
传递给步骤定义方法的参数是一个正则表达式,用于匹配 Gherkin .feature 文件中的一个或多个步骤。上面的例子符合以下步骤:
Given there is a user named "Ade Tester"
(“Ade Tester”可以是任何东西)。
传递给步骤定义方法的块在 Cucumber 执行正则表达式匹配的步骤时运行。它可以包含任何你喜欢的 Ruby 代码。
正则表达式中的匹配组(括在括号中)作为块参数传递给块。匹配组的数量必须与块参数的数量匹配,否则会出错。一个常见的约定是将匹配字符串的匹配组括在引号中,以便在视觉上将它们与步骤的固定部分分开,就像我在上面所做的那样,但这纯粹是约定,您可以选择不这样做。
默认情况下,正则表达式不需要匹配整个步骤。如果您希望定义仅匹配整个步骤,则必须在正则表达式中强制执行,就像我在上面的示例中使用 ^ 和 $ 所做的那样。除非你有充分的理由不这样做。此步骤定义(不含$)
Given /^there is a user named "(.*)"/ do |username|
create :user, username: username
end
会匹配
Given there is a user named "Ade Tester" on weekdays but "Dave Schweisguth" on weekends
这可能是个坏主意。更糟糕的是,如果您对这两个步骤都有定义,Cucumber 将无法判断要使用哪个定义,并且您会收到错误消息。
在 features/step_definitions/documentation.rb 中:
When /^I go to the "([^"]+)" documentation$/ do |section|
path_part =
case section
when "Documentation"
"documentation"
else
raise "Unknown documentation section: #{section}"
end
visit "/documentation/#{path_part}/topics"
end
Then /^I should see the "([^"]+) documentation"$/ do |section|
expect(page).to have_css('h2.doctag_title a', text: section)
end
这些步骤将运行一个 Web 应用程序。它们尽可能简单,同时仍然实用。