如何解决 Capybara 中的歧义?出于某种原因,我需要页面中具有相同值的链接,但由于出现错误,我无法创建测试
Failure/Error: click_link("#tag1")
Capybara::Ambiguous:
Ambiguous match, found 2 elements matching link "#tag1"
我无法避免这种情况的原因是因为设计。我正在尝试使用右侧的推文/标签和页面左侧的标签重新创建 twitter 页面。因此,相同的链接页面不可避免地会出现在同一页面上。
我的解决方案是
first(:link, link).click
代替
click_link(link)
Capybara 的这种行为是故意的,我认为不应像大多数其他答案中所建议的那样对其进行修复。
Capybara 2.0 之前的版本返回第一个元素而不是引发异常,但后来 Capybara 的维护者认为这是一个坏主意,最好提高它。决定在许多情况下返回第一个元素导致返回的不是开发人员想要返回的元素。
此处最受好评的答案建议使用 first
或 all
而不是 find
但是:
all and first 不要等到带有此类定位器的元素出现在页面上,尽管 find 确实等待 all(...).first and first 不会保护您免受将来另一个带有此类定位器的元素可能出现在页面上的情况页面,结果您可能会发现不正确的元素
所以it's adviced to choose another, less ambiguous locator:例如通过 id、class 或其他 css/xpath 定位器选择元素,这样只有一个元素会匹配它。
作为注释,这里有一些我通常认为在解决歧义时有用的定位器:
find('ul > li:first-child') 它比 first('ul > li') 更有用,因为它会等到第一个 li 出现在页面上。
click_link('Create Account', match: :first) 比 first(:link, 'Create Account').click 更好,因为它会等到页面上至少出现一个 Create Account 链接。但是我认为最好选择不会出现在页面上两次的唯一定位器。
fill_in('Password', with: 'secret', exact: true) exact: true 告诉 Capybara 只查找完全匹配,即不查找“密码确认”
上述解决方案效果很好,但对于那些好奇的人,您也可以使用以下语法。
click_link(link_name, match: :first)
您可以在这里找到更多信息:
新答案:
你可以尝试类似的东西
all('a').select {|elt| elt.text == "#tag1" }.first.click
可能有一种方法可以更好地利用可用的 Capybara 语法——类似于 all("a[text='#tag1']").first.click
的内容,但我想不出正确的语法,也找不到合适的文档。也就是说,一开始情况有点奇怪,两个 <a>
标记具有相同的 id
、class
和文本。有没有可能他们是不同 div 的孩子,因为您可以在 find
within
DOM 的适当部分。 (这将有助于查看您的一些 HTML 源代码)。
旧答案:(我认为“#tag1”表示该元素的 id
为“tag1”)
您想点击哪个链接?如果是第一个(或者没关系),你可以做
find('#tag1').click
否则你可以做
all('#tag1')[1].click
单击第二个。
find('#tag1')
表示您只想找到一个 ID 为 tag1
的元素。引发异常,因为页面上有多个 ID 为 tag1
的元素
all(:xpath, '//a[text()="#tag1"]').first.click
。
您可以确保使用 match
找到第一个:
find('.selector', match: :first).click
但重要的是,您可能不想这样做,因为它会导致忽略重复输出代码气味的脆弱测试,进而导致误报,当它们应该失败时继续工作,因为您删除了一个匹配元素,但测试愉快地找到了另一个。
更好的选择是使用 within
:
within('#sidebar') do
find('.selector).click
end
这可确保您找到希望找到的元素,同时仍利用 Capybara 的自动等待和自动重试功能(如果使用 find('.selector').click
,则会丢失这些功能),并且更清楚意图是什么.
要在此处添加现有知识体系:
对于 JS 测试,Capybara 必须保持两个线程(一个用于 RSpec,一个用于 Rails)和第二个进程(浏览器)同步。它通过在大多数匹配器和节点查找方法中等待(直到配置的最大等待时间)来做到这一点。
Capybara 也有不等待的方法,主要是 Node#all
。使用它们就像告诉您的规格您希望它们间歇性地失败。
接受的答案建议page.first('selector')
。这是不可取的,至少对于 JS 规范,因为 Node#first
uses Node#all
.
也就是说,如果您像这样配置 Capybara,Node#first
将等待:
# rails_helper.rb
Capybara.wait_on_first_by_default = true
此选项为 added in Capybara 2.5.0,默认为 false。
正如安德烈提到的,你应该改用
find('selector', match: :first)
或更改您的选择器。无论配置或驱动程序如何,都可以正常工作。
更复杂的是,在 Capybara 的旧版本(或启用了配置选项)中,#find
会很高兴地忽略歧义并只返回第一个匹配的选择器。这也不是很好,因为它使您的规范不那么明确,我想这就是为什么不再是默认行为。我将省略细节,因为它们已经在上面讨论过。
更多资源:
https://thoughtbot.com/blog/write-reliable-asynchronous-integration-tests-with-capybara
https://makandracards.com/makandra/20829-threads-and-processes-in-a-capybara-selenium-session
考虑到上述所有选项,您也可以尝试一下
find("a", text: text, match: :prefer_exact).click
如果你用的是黄瓜,你也可以按照这个
您可以从场景步骤中将文本作为参数传递,这可以是通用步骤以再次重用
When a user clicks on "text" link
之类的东西
并在步骤定义 When(/^(?:user) clicks on "([^"]*)" (?:link)$/) do |text|
这样,您可以通过最小化代码行来重用相同的步骤,并且可以轻松编写新的黄瓜场景
避免在黄瓜中出现模棱两可的错误。
解决方案 1
first("#tag1").click
解决方案 2
Cucumber features/filename.feature --guess
不定期副业成功案例分享
first
,除非您完全知道自己在做什么,否则可能会导致规范通过,但在 CI 构建或同事的机器上失败。