capybara-skill

Capybara 自動化スキル

基本パターン

基本的なテスト（RSpec）

require 'capybara/rspec'

RSpec.describe 'Login', type: :feature do
  it 'logs in with valid credentials' do
    visit '/login'
    fill_in 'Email', with: '[email protected]'
    fill_in 'Password', with: 'password123'
    click_button 'Login'
    expect(page).to have_content('Dashboard')
    expect(page).to have_current_path('/dashboard')
  end

  it 'shows error for invalid credentials' do
    visit '/login'
    fill_in 'Email', with: '[email protected]'
    fill_in 'Password', with: 'wrong'
    click_button 'Login'
    expect(page).to have_content('Invalid credentials')
  end
end

DSL

# Navigation
visit '/path'
go_back
go_forward

# Interacting
fill_in 'Label or Name', with: 'text'
choose 'Radio Label'
check 'Checkbox Label'
uncheck 'Checkbox Label'
select 'Option', from: 'Select Label'
attach_file 'Upload', '/path/to/file'
click_button 'Submit'
click_link 'More Info'
click_on 'Button or Link'

# Finding
find('#id')
find('.class')
find('[data-testid="x"]')
find(:xpath, '//div')
all('.items').count

# Matchers
expect(page).to have_content('text')
expect(page).to have_selector('#element')
expect(page).to have_css('.class')
expect(page).to have_button('Submit')
expect(page).to have_field('Email')
expect(page).to have_link('Click Here')
expect(page).to have_current_path('/expected')
expect(page).to have_no_content('error')

スコープ内

within('#login-form') do
  fill_in 'Email', with: '[email protected]'
  click_button 'Login'
end

within_table('users') do
  expect(page).to have_content('Alice')
end

TestMu AI Cloud

Capybara.register_driver :lambdatest do |app|
  caps = Selenium::WebDriver::Remote::Capabilities.new(
    browserName: 'chrome',
    'LT:Options' => {
      user: ENV['LT_USERNAME'], accessKey: ENV['LT_ACCESS_KEY'],
      build: 'Capybara Build', name: 'Login Test',
      platform: 'Windows 11', video: true
    }
  )
  Capybara::Selenium::Driver.new(app,
    browser: :remote,
    url: 'https://hub.lambdatest.com/wd/hub',
    capabilities: caps)
end
Capybara.default_driver = :lambdatest

セットアップ：Gemfile に gem 'capybara' と gem 'selenium-webdriver' を追加します

実行：bundle exec rspec spec/features/

クラウド（TestMu AI）

リモートブラウザーで実行する場合は、reference/cloud-integration.md と shared/testmu-cloud-reference.md を参照してください。

詳細なパターン

本番環境向けのパターンについては、reference/playbook.md を参照してください。

セクション	内容
§1 プロジェクトのセットアップ	Gemfile、Capybara の設定、ドライバーの登録、LambdaTest
§2 機能スペック	ログインフロー、JavaScript の操作、モーダル、非同期コンテンツ
§3 ページオブジェクト	要素やセクションを含む SitePrism ページ、スペックでの使用方法
§4 API テスト	認証ヘッダーを使ったリクエストスペック、JSON アサーション
§5 データベースのクリーニング	DatabaseCleaner のトランザクション／トランケーション戦略
§6 マッチャーとヘルパー	カスタムヘルパー、sign_in、expect_flash
§7 CI/CD 統合	Postgres、Redis、Chrome を使った GitHub Actions
§8 デバッグ表	よくある問題 12 件とその原因・解決策
§9 ベストプラクティス	Capybara テストの 14 項目チェックリスト