testcentricity_web 4.1.8 → 4.1.9

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ec1cf64d0d0e52b5d49ce5980dc049add4befecbc830650c4c908db5b2e07ac2
-  data.tar.gz: 841d00666f64914cf72d0f279e060c5ba31c1eb8a056020015a1430daf9c38a6
+  metadata.gz: c35f1c09951d1a58be2d3bac921d2d221311edf3b4464c5d4806c7a30a57c0f2
+  data.tar.gz: bbe72af137b6808721f7a87b26032c42d78bbf4708ff88ed34c753ebcec85c46
 SHA512:
-  metadata.gz: 1e4e6f516c68a18689ccecfa7ee52ca97db9ffb8641c63d21641061e70ca4ac0f1b53d5191b02c6335ac1403e6bdf8afe0b0133d1204f2b87d4496d00a4c4fc1
-  data.tar.gz: c38230893848b6145e79e131f9e6a99867fa0a1d590d2b272a00709ee107b9a8044180c037cd1182cd6aa13d58c208e3ce154c2de08b66161a7c06ce02e0a8bc
+  metadata.gz: 0607f397cd9d6564623218d3e88f541a04f17c9b4b8cc96eb50571bc787cfa46927651dc38cfc7765129dd33303fbd3c130720dc809940cf401a336756c3d7c1
+  data.tar.gz: 11cc150624658854f69575361345dca970a3cf567e1b29e6797450dc22df88f53b069374a63ab8e12f83e7638a28386b0edd0d96e6707720f41e1e6fa621c1f5

data/.gitignore

@@ -15,6 +15,7 @@ Thumbs.db
 /pkg/
 /spec/reports/
 /tmp/
+Gemfile*.lock
 
 # rspec failure tracking
 .rspec_status

data/.rspec

@@ -1,3 +1,4 @@
---format documentation
+# General configuration options
 --color
 --require spec_helper
+--format documentation

data/.ruby-version

@@ -0,0 +1 @@
+ruby-2.7.5

data/CHANGELOG.md

@@ -2,6 +2,19 @@
 All notable changes to this project will be documented in this file.
 
 
+## [4.1.9] - 18-APR-2022
+
+### Fixed
+* `PageSection.radio` no longer returns `wrong number of arguments` error.
+* `PageObject.populate_data_fields` and `PageSection.populate_data_fields` methods no longer skip setting checkboxes or
+radio buttons to the unchecked state.
+
+### Added
+
+* `CheckBox.define_custom_elements` and `Radio.define_custom_elements` methods now support specifying a child `input` component
+contained by a top level `label` element.
+
+
 ## [4.1.8] - 31-MAR-2022
 
 ### Fixed

data/README.md

@@ -874,7 +874,7 @@ present a challenge when attempting to interact with them using Capybara and Sel
 Sometimes, radio buttons and checkboxes implemented using JS component libraries cannot be interacted with due to other UI elements
 being overlaid on top of them and the base `input(type='radio')` or `input(type='checkbox')` element not being visible.
 
-In the screenshots below of an airline flight search and booking page, the **Roundtrip** and **One-way** radio buttons are adorned with
+In the screenshots below of an airline flight search and booking page, the **Roundtrip** and **One-way** radio buttons are adorned by
 `label` elements that also acts as proxies for their associated `input(type='radio')` elements, and they intercept the `click` actions
 that would normally be handled by the `input(type='radio')` elements.
 
@@ -892,27 +892,26 @@ elements.
 <img src="https://i.imgur.com/JcOANqZ.jpg" alt="One-way Radio button Label" title="One-way Radio button Label">
 
 
-The `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods provide a way to specify the `proxy` and/or `label`
-elements associated with the `input(type='radio')` or `input(type='checkbox')` elements. The `define_custom_elements` method
-should be called from an `initialize` method for the `PageObject` or `PageSection` where the `radio` or `checkbox` element is instantiated.
-The code snippet below demonstrates the use of the `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods to
-resolve the testability issues posed by the adorned **Roundtrip** and **One-way** radio buttons and the **Flexible dates** checkbox.
+The `Radio.define_custom_elements` and `CheckBox.define_custom_elements` methods provide a way to specify the `input`, `proxy`
+and/or `label` elements associated with the `input(type='radio')` or `input(type='checkbox')` elements. The `define_custom_elements`
+method should be called from an `initialize` method for the `PageObject` or `PageSection` where the `radio` or `checkbox` element is
+instantiated. The code snippet below demonstrates the use of the `Radio.define_custom_elements` and `CheckBox.define_custom_elements`
+methods to resolve the testability issues posed by the adorned **Roundtrip** and **One-way** radio buttons and the **Flexible dates**
+checkbox.
 
     class FlightBookingPage < TestCentricity::PageObject
       trait(:page_name)    { 'Flight Booking Home' }
       trait(:page_locator) { "div[class*='bookerContainer']" }
       
       # Flight Booking page UI elements
-      radios   roundtrip_radio: 'input#roundtrip',
-               one_way_radio:   'input#oneway'
+      radios   roundtrip_radio: "label[for='roundtrip']",
+               one_way_radio:   "label[for='oneway']"
       checkbox :flexible_check, 'input#flexibleDates'
       
       def initialize
-        # define the custom element components for the Round Trip radio button
-        radio_spec = { proxy: "label[for='roundtrip']" }
+        # define the custom element components for the Round Trip and One Way radio buttons
+        radio_spec = { input: "input[type='radio']" }
         roundtrip_radio.define_custom_elements(radio_spec)
-        # define the custom element components for the One Way radio button
-        radio_spec = { proxy: "label[for='oneway']" }
         one_way_radio.define_custom_elements(radio_spec)
         # define the custom element components for the Flexible Date checkbox
         check_spec = { proxy: 'label#flexDatesLabel' }

data/Rakefile

@@ -1,86 +1,115 @@
 require 'rubygems'
 require 'cucumber'
 require 'cucumber/rake/task'
+require 'docker/compose'
+require 'parallel_tests'
 require 'rake'
+require 'rspec/core/rake_task'
+require 'simplecov'
+require 'yard'
 
 
-namespace :features do
-  Cucumber::Rake::Task.new(:edge_local) do |t|
-    t.profile = 'edge_local'
-  end
+desc 'Run required specs'
+RSpec::Core::RakeTask.new(:required_specs) do |t|
+  t.rspec_opts = '--tag required'
+end
 
-  Cucumber::Rake::Task.new(:chrome_local) do |t|
-    t.profile = 'chrome_local'
-  end
 
-  Cucumber::Rake::Task.new(:edge_headless) do |t|
-    t.profile = 'edge_headless'
-  end
+desc 'Run grid WebDriver specs'
+RSpec::Core::RakeTask.new(:grid_specs) do |t|
+  t.rspec_opts = '--tag grid'
+end
 
-  Cucumber::Rake::Task.new(:chrome_headless) do |t|
-    t.profile = 'chrome_headless'
-  end
 
-  Cucumber::Rake::Task.new(:safari_local) do |t|
-    t.profile = 'safari_local'
-  end
+desc 'Run mobile WebDriver specs'
+RSpec::Core::RakeTask.new(:mobile_specs) do |t|
+  t.rspec_opts = '--tag mobile'
+end
 
-  Cucumber::Rake::Task.new(:firefox_local) do |t|
-    t.profile = 'firefox_local'
-  end
 
-  Cucumber::Rake::Task.new(:firefox_headless) do |t|
-    t.profile = 'firefox_headless'
-  end
+desc 'Run Cucumber features on local Safari browser'
+Cucumber::Rake::Task.new(:safari_local) do |t|
+  t.profile = 'safari_local'
+end
 
-  Cucumber::Rake::Task.new(:edge_grid) do |t|
-    t.profile = 'edge_grid'
-  end
 
-  Cucumber::Rake::Task.new(:chrome_grid) do |t|
-    t.profile = 'chrome_grid'
-  end
+desc 'Run Cucumber features on iOS simulator'
+Cucumber::Rake::Task.new(:ios_remote) do |t|
+  t.profile = 'ios_remote'
+end
 
-  Cucumber::Rake::Task.new(:firefox_grid) do |t|
-    t.profile = 'firefox_grid'
-  end
 
-  Cucumber::Rake::Task.new(:ios_remote) do |t|
-    t.profile = 'ios_remote'
+desc 'Run required Cucumber features on local web browsers'
+task :required_cukes do
+  %w[chrome_local chrome_headless firefox_local firefox_headless edge_local edge_headless ipad_pro_12_local].each do |profile|
+    system "parallel_cucumber features/ -o '-p #{profile}' -n 6 --group-by scenarios"
   end
+end
 
-  Cucumber::Rake::Task.new(:emulated_mobile) do |t|
-    t.profile = 'ipad_pro_12_local'
+
+desc 'Run grid Cucumber features on Dockerized Selenium 4 Grid'
+task :grid_cukes do
+  # start up Selenium 4 Grid
+  compose = Docker::Compose.new
+  compose.version
+  compose.up(detached: true)
+  # run grid features
+  %w[chrome_grid firefox_grid edge_grid ipad_pro_12_grid].each do |profile|
+    system "parallel_cucumber features/ -o '-p #{profile}' -n 4 --group-by scenarios"
   end
+  # shut down Selenium Grid
+  compose.down(remove_volumes: true)
+end
 
 
-  task :required => [
-    :edge_local,
-    :edge_headless,
-    :chrome_local,
-    :chrome_headless,
-    :firefox_local,
-    :firefox_headless,
-    :safari_local,
-    :emulated_mobile,
-  ]
-
-  task :grid => [:edge_grid, :chrome_grid, :firefox_grid]
-
-  task :mobile => [:ios_remote]
-
-  task :all => [
-    :edge_local,
-    :edge_headless,
-    :chrome_local,
-    :chrome_headless,
-    :firefox_local,
-    :firefox_headless,
-    :safari_local,
-    :edge_grid,
-    :chrome_grid,
-    :firefox_grid,
-    :emulated_mobile,
-    :ios_remote
-  ]
+desc 'Run grid specs on Dockerized Selenium 4 Grid'
+task :docker_grid_specs do
+  # start up Selenium 4 Grid
+  compose = Docker::Compose.new
+  compose.version
+  compose.up(detached: true)
+  # run grid specs
+  Rake::Task[:grid_specs].invoke
+  # shut down Selenium Grid
+  compose.down(remove_volumes: true)
 end
+
+
+desc 'Run mobile web specs and Cucumber features'
+task mobile: [:mobile_specs, :ios_remote]
+
+
+desc 'Run required specs and Cucumber features'
+task required: [:required_specs, :required_cukes]
+
+
+desc 'Run grid specs and Cucumber features on Dockerized Selenium 4 Grid'
+task grid: [:docker_grid_specs, :grid_cukes]
+
+
+desc 'Run all specs'
+task all_specs: [:required_specs, :docker_grid_specs, :mobile_specs]
+
+
+desc 'Run all specs and Cucumber features'
+task all: [:required, :safari_local, :grid, :mobile]
+
+
+desc 'Update HTML docs'
+YARD::Rake::YardocTask.new(:docs) do |t|
+  t.files = ['lib/**/*.rb']
+end
+
+
+desc 'Build and release new version'
+task :release do
+  version = TestCentricityWeb::VERSION
+  puts "Releasing #{version}, y/n?"
+  exit(1) unless $stdin.gets.chomp == 'y'
+  sh 'gem build testcentricity_web.gemspec && ' \
+     "gem push testcentricity_web-#{version}.gem"
+end
+
+
+desc 'Update docs, build gem, and push to RubyGems'
+task ship_it: [:docs, :release]

data/config/cucumber.yml

@@ -63,6 +63,7 @@ portrait:  ORIENTATION=portrait
 
 ipad_pro_11_local: --profile local WEB_BROWSER=ipad_pro_11 HOST_BROWSER=chrome --profile portrait <%= mobile %>
 ipad_pro_12_local: --profile local WEB_BROWSER=ipad_pro_12_9 HOST_BROWSER=chrome --profile portrait <%= mobile %>
+ipad_pro_12_grid: --profile grid WEB_BROWSER=ipad_pro_12_9 HOST_BROWSER=chrome --profile portrait <%= mobile %>
 
 
 #==============

data/config/locales/en-US.yml

@@ -0,0 +1,56 @@
+# Localization file for English/U.S. locale.
+
+en-US:
+  time:
+    formats:
+      default: "%m/%d/%Y"
+      long: "%B %d, %Y"
+      short: "%b %d"
+      abbrev: "%b %d, %Y"
+      abbrev_month: "%b"
+      month_year: "%B %Y"
+  date:
+    abbr_day_names:
+    - Sun
+    - Mon
+    - Tue
+    - Wed
+    - Thu
+    - Fri
+    - Sat
+    abbr_month_names:
+    -
+    - Jan
+    - Feb
+    - Mar
+    - Apr
+    - May
+    - Jun
+    - Jul
+    - Aug
+    - Sep
+    - Oct
+    - Nov
+    - Dec
+    day_names:
+    - Sunday
+    - Monday
+    - Tuesday
+    - Wednesday
+    - Thursday
+    - Friday
+    - Saturday
+    month_names:
+    -
+    - January
+    - February
+    - March
+    - April
+    - May
+    - June
+    - July
+    - August
+    - September
+    - October
+    - November
+    - December

data/{docker-compose-v3.yml → docker-compose.yml}

@@ -1,6 +1,6 @@
-# To execute this docker-compose yml file use `docker-compose -f docker-compose-v3.yml up`
+# To execute this docker-compose yml file use `docker-compose -f docker-compose.yml up`
 # Add the `-d` flag at the end for detached execution
-# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose-v3.yml down`
+# To stop the execution, hit Ctrl+C, and then `docker-compose -f docker-compose.yml down`
 version: "3"
 services:
   chrome:

data/features/basic_form_page_css.feature

@@ -12,7 +12,7 @@ Feature: Basic HTML Form Test Page using CSS locators
     Then I expect the Basic CSS Form page to be correctly displayed
 
 
-@!mobile @!firefox_headless
+@!mobile @!firefox_headless @!firefox_grid
   Scenario: Validate verify_focus_order method
     Then I expect the tab order to be correct
 
@@ -24,6 +24,21 @@ Feature: Basic HTML Form Test Page using CSS locators
     Then I expect the Basic CSS Form page to be correctly displayed
 
 
+  Scenario Outline:  Choose selectlist options by index, value, and text
+    When I choose selectlist options by <method>
+    Then I expect the selected option to be displayed
+
+    Examples:
+      |method |
+      |index  |
+      |text   |
+
+@!safari @!firefox @!firefox_headless
+    Examples:
+      |method |
+      |value  |
+
+
   Scenario Outline:  Verify functionality of navigation tabs and browser back/forward
     When I click the <target_page> navigation tab
     Then I expect the <target_page> page to be correctly displayed

data/features/custom_controls.feature

@@ -0,0 +1,29 @@
+Feature: Custom Controls
+  In order to ensure comprehensive support for custom UI elements
+  As a developer of the TestCentricity web gem
+  I expect to validate the interaction and verification capabilities of custom UI elements
+
+
+  Background:
+    Given I am on the Custom Controls page
+
+
+  Scenario: Validate populate_data_fields method and associated object action methods
+    When I populate the form fields
+    Then I expect the form fields to be correctly populated
+
+
+@!safari @!firefox @!firefox_headless @!ios
+  Scenario: Use custom select list input field to choose options
+    When I choose custom select options by typing
+    Then I expect the form fields to be correctly populated
+
+
+  Scenario Outline:  Choose selectlist options by index and text
+    When I choose selectlist options by <method>
+    Then I expect the selected option to be displayed
+
+    Examples:
+      |method |
+      |index  |
+      |text   |

data/features/media_players.feature

@@ -1,3 +1,6 @@
+@!grid @!mobile
+
+
 Feature: HTML5 Audio/Video Test Page using CSS locators
   In order to ensure comprehensive support for HTML5 Audio and Video media elements
   As a developer of the TestCentricity web gem
@@ -49,18 +52,8 @@ Feature: HTML5 Audio/Video Test Page using CSS locators
   Scenario:  Verify video playback speed settings
     When I play the video with a playback speed of 2x
     Then the video should play at 2x speed
-    When I play the video with a playback speed of 0.25x
-    Then the video should play at 0.25x speed
-    When I play the video with a playback speed of 1.75x
-    Then the video should play at 1.75x speed
     When I play the video with a playback speed of 0.5x
     Then the video should play at 0.5x speed
-    When I play the video with a playback speed of 1.5x
-    Then the video should play at 1.5x speed
-    When I play the video with a playback speed of 0.75x
-    Then the video should play at 0.75x speed
-    When I play the video with a playback speed of 1.25x
-    Then the video should play at 1.25x speed
     When I play the video with a playback speed of 1x
     Then the video should play at 1x speed
 
@@ -68,17 +61,7 @@ Feature: HTML5 Audio/Video Test Page using CSS locators
   Scenario:  Verify audio playback speed settings
     When I play the audio with a playback speed of 2x
     Then the audio should play at 2x speed
-    When I play the audio with a playback speed of 0.25x
-    Then the audio should play at 0.25x speed
-    When I play the audio with a playback speed of 1.75x
-    Then the audio should play at 1.75x speed
     When I play the audio with a playback speed of 0.5x
     Then the audio should play at 0.5x speed
-    When I play the audio with a playback speed of 1.5x
-    Then the audio should play at 1.5x speed
-    When I play the audio with a playback speed of 0.75x
-    Then the audio should play at 0.75x speed
-    When I play the audio with a playback speed of 1.25x
-    Then the audio should play at 1.25x speed
     When I play the audio with a playback speed of 1x
     Then the audio should play at 1x speed

data/features/step_definitions/generic_steps.rb.rb

@@ -107,3 +107,18 @@ end
 When(/^I set device orientation to (.*)$/) do |orientation|
   Browsers.set_device_orientation(orientation.downcase.to_sym)
 end
+
+
+When(/^I choose custom select options by typing$/) do
+  custom_controls_page.set_select_options
+end
+
+
+When(/^I choose selectlist options by (.*)$/) do |method|
+  PageManager.current_page.choose_options_by(method)
+end
+
+
+Then(/^I expect the selected option to be displayed$/) do
+  PageManager.current_page.verify_chosen_options
+end

data/features/support/env.rb

@@ -7,7 +7,8 @@ require 'testcentricity_web'
 
 include TestCentricity
 
-SimpleCov.command_name("features-#{ENV['WEB_BROWSER']}-#{ENV['SELENIUM']}" + (ENV['TEST_ENV_NUMBER'] || ''))
+coverage_report_name = "Features-#{ENV['WEB_BROWSER']}-#{ENV['SELENIUM']}" + (ENV['TEST_ENV_NUMBER'] || '')
+SimpleCov.command_name("#{coverage_report_name}-#{Time.now.strftime('%Y%m%d%H%M%S%L')}")
 
 require_relative 'world_data'
 require_relative 'world_pages'
@@ -42,7 +43,7 @@ WorldPages.instantiate_page_objects
 Webdrivers.cache_time = 86_400
 
 
-url = if ENV['TEST_ENVIRONMENT'].downcase == 'local'
+url = if Environ.test_environment == :local
         "file://#{File.dirname(__FILE__)}/../../test_site"
       else
         Environ.current.app_host

data/features/support/hooks.rb

@@ -104,6 +104,11 @@ Around('@!firefox') do |scenario, block|
 end
 
 
+Around('@!firefox_headless') do |scenario, block|
+  qualify_browser(:firefox_headless, 'Firefox headless', scenario, block)
+end
+
+
 # block feature/scenario execution if running against iPad mobile browser
 Around('@!ipad') do |scenario, block|
   qualify_device('ipad', scenario, block)
@@ -200,9 +205,9 @@ Around('@!headless') do |scenario, block|
 end
 
 
-Around('@!firefox_headless') do |scenario, block|
-  if Environ.browser == :firefox_headless
-    log "Scenario '#{scenario.name}' can not be executed on headless Firefox browsers."
+Around('@!firefox_grid') do |scenario, block|
+  if Environ.browser == :firefox && Environ.grid
+    log "Scenario '#{scenario.name}' can not be executed on grid hosted Firefox browsers."
     skip_this_scenario
   else
     block.call

data/features/support/pages/base_test_page.rb

@@ -2,7 +2,7 @@
 
 class BaseTestPage < TestCentricity::PageObject
   # Base Test page UI elements
-  label    :header_label, 'h2'
+  label    :header_label, 'h2#header'
   sections header_nav:    NavHeader
 
   def navigate_to

data/features/support/pages/basic_css_form_page.rb

@@ -24,6 +24,7 @@ class BasicCSSFormPage < BasicFormPage
               radio_4:           'input#radio4'
   selectlists multi_select:      'select#multipleselect',
               drop_down_select:  'select#dropdown'
+  lists       links_list:        'ul#links_list'
   links       link_1:            'a#link1',
               link_2:            'a#link2',
               link_3:            'a#link3'

data/features/support/pages/basic_form_page.rb

@@ -233,6 +233,12 @@ class BasicFormPage < BaseTestPage
         selected: 'Drop Down Item 1'
       },
       link_label        => { visible: true, caption: 'Links:' },
+      links_list        => {
+        visible: true,
+        enabled: true,
+        itemcount: 3,
+        items: ['Open Media Page in same window/tab', 'Open Media Page in a new window/tab', 'Disabled Link']
+      },
       link_1            => {
         visible: true,
         href: { ends_with: 'media_page.html' },
@@ -315,15 +321,21 @@ class BasicFormPage < BaseTestPage
       check1:       data.check1,
       check2:       data.check2,
       check3:       data.check3,
-      radio1:       false,
-      radio2:       true,
-      radio3:       false,
+      radio_select: data.radio_select,
       multi_select: data.multi_select,
       drop_select:  data.drop_down_item
     }
   end
 
   def populate_form
+    # toggle checks and radios and verify
+    check_2.check
+    check_2.verify_check_state(true)
+    check_2.uncheck
+    check_2.verify_check_state(false)
+    radio_2.select
+    radio_2.unselect
+    # populate fields and controls with externally sourced data
     @data = form_data
     fields = {
       username_field   => @data[:username],
@@ -337,9 +349,9 @@ class BasicFormPage < BaseTestPage
       check_1          => @data[:check1],
       check_2          => @data[:check2],
       check_3          => @data[:check3],
-      radio_1          => @data[:radio1],
-      radio_2          => @data[:radio2],
-      radio_3          => @data[:radio3],
+      radio_1          => @data[:radio_select] == 1,
+      radio_2          => @data[:radio_select] == 2,
+      radio_3          => @data[:radio_select] == 3,
       multi_select     => @data[:multi_select],
       drop_down_select => @data[:drop_select]
     }
@@ -359,9 +371,9 @@ class BasicFormPage < BaseTestPage
       check_1          => { checked: @data[:check1] },
       check_2          => { checked: @data[:check2] },
       check_3          => { checked: @data[:check3] },
-      radio_1          => { selected: @data[:radio1] },
-      radio_2          => { selected: @data[:radio2] },
-      radio_3          => { selected: @data[:radio3] },
+      radio_1          => { selected: @data[:radio_select] == 1 },
+      radio_2          => { selected: @data[:radio_select] == 2 },
+      radio_3          => { selected: @data[:radio_select] == 3 },
       multi_select     => { selected: @data[:multi_select] },
       drop_down_select => { selected: @data[:drop_select] }
     }
@@ -390,4 +402,28 @@ class BasicFormPage < BaseTestPage
             end
     verify_focus_order(order)
   end
+
+  def choose_options_by(method)
+    case method.downcase.to_sym
+    when :index
+      multi_select.choose_option(index: 2)
+      drop_down_select.choose_option(index: 3)
+    when :value
+      multi_select.choose_option(value: 'ms2')
+      drop_down_select.choose_option(value: 'dd3')
+    when :text
+      multi_select.choose_option(text: 'Selection Item 2')
+      drop_down_select.choose_option(text: 'Drop Down Item 3')
+    else
+      raise "#{method} is not a valid selector"
+    end
+  end
+
+  def verify_chosen_options
+    ui = {
+      multi_select     => { selected: 'Selection Item 2' },
+      drop_down_select => { selected: 'Drop Down Item 3' }
+    }
+    verify_ui_states(ui)
+  end
 end

data/features/support/pages/basic_xpath_form_page.rb

@@ -24,6 +24,7 @@ class BasicXpathFormPage < BasicFormPage
               radio_4:           "//input[@id='radio4']"
   selectlists multi_select:      "//select[@id='multipleselect']",
               drop_down_select:  "//select[@id='dropdown']"
+  lists       links_list:        "//ul[@id='links_list']"
   links       link_1:            "//a[@id='link1']",
               link_2:            "//a[@id='link2']",
               link_3:            "//a[@id='link3']"