testcentricity_web 4.1.6 → 4.1.9

data/spec/testcentricity_web/elements/video_spec.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+describe TestCentricity::Video, required: true do
+  subject(:css_video) { described_class.new(:test_video, self, 'video#css_video', :page) }
+
+  it 'returns class' do
+    expect(css_video.class).to eql TestCentricity::Video
+  end
+
+  it 'registers with type video' do
+    expect(css_video.get_object_type).to eql :video
+  end
+
+  it 'returns autoplay' do
+    allow(css_video).to receive(:autoplay?).and_return(false)
+    expect(css_video.autoplay?).to eql false
+  end
+
+  it 'returns controls' do
+    allow(css_video).to receive(:controls?).and_return(true)
+    expect(css_video.controls?).to eql true
+  end
+
+  it 'returns ended' do
+    allow(css_video).to receive(:ended?).and_return(true)
+    expect(css_video.ended?).to eql true
+  end
+
+  it 'returns loop' do
+    allow(css_video).to receive(:loop?).and_return(false)
+    expect(css_video.loop?).to eql false
+  end
+
+  it 'returns muted' do
+    allow(css_video).to receive(:muted?).and_return(false)
+    expect(css_video.muted?).to eql false
+  end
+
+  it 'returns paused' do
+    allow(css_video).to receive(:paused?).and_return(true)
+    expect(css_video.paused?).to eql true
+  end
+
+  it 'returns seeking' do
+    allow(css_video).to receive(:seeking?).and_return(false)
+    expect(css_video.seeking?).to eql false
+  end
+
+  it 'should play the video' do
+    expect(css_video).to receive(:play)
+    css_video.play
+  end
+
+  it 'should pause the video' do
+    expect(css_video).to receive(:pause)
+    css_video.pause
+  end
+
+  it 'should mute the video' do
+    expect(css_video).to receive(:mute)
+    css_video.mute
+  end
+
+  it 'should unmute the video' do
+    expect(css_video).to receive(:unmute)
+    css_video.unmute
+  end
+end

data/spec/testcentricity_web/helper_specs/object_helpers_spec.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+describe Object, required: true do
+  it 'returns true when blank' do
+    [nil, {}, ''].each do |value|
+      expect(value.blank?).to eql true
+    end
+  end
+
+  it 'returns false when not blank' do
+    [0, 42, 'fred', ['Fred', 21], {a: 42}].each do |value|
+      expect(value.blank?).to eql false
+    end
+  end
+
+  it 'returns true when present' do
+    [0, 42, 'fred', ['Fred', 21], {a: 42}].each do |value|
+      expect(value.present?).to eql true
+    end
+  end
+
+  it 'returns false when not present' do
+    [nil, {}, ''].each do |value|
+      expect(value.present?).to eql false
+    end
+  end
+
+  it 'returns true when Boolean' do
+    [!nil?, nil?, 2 + 2 == 4].each do |value|
+      expect(value.boolean?).to eql true
+    end
+  end
+
+  it 'returns false when not a Boolean' do
+    [4, 'Ethel', [1, 'a']].each do |value|
+      expect(value.boolean?).to eql false
+    end
+  end
+end

data/spec/testcentricity_web/helper_specs/string_helpers_spec.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+describe String, required: true do
+  it 'returns string between' do
+    expect('The rain in Spain'.string_between('The ', ' Spain')).to eql 'rain in'
+  end
+
+  it 'returns title case' do
+    expect('The rain in Spain'.titlecase).to eql 'The Rain In Spain'
+  end
+
+  it 'returns boolean value when true' do
+    %w[true t yes y x 1].each do |value|
+      expect(value.to_bool).to eql true
+    end
+  end
+
+  it 'returns boolean value when false' do
+    %w[false f no n 0].each do |value|
+      expect(value.to_bool).to eql false
+    end
+  end
+
+  it 'returns true when Integer' do
+    %w[26 3 10345].each do |value|
+      expect(value.is_int?).to eql true
+    end
+  end
+
+  it 'returns false when not an Integer' do
+    %w[271.234 0.1234 Fred].each do |value|
+      expect(value.is_int?).to eql false
+    end
+  end
+
+  it 'returns true when Float' do
+    %w[271.234 0.1234 21.4].each do |value|
+      expect(value.is_float?).to eql true
+    end
+  end
+
+  it 'returns formatted date' do
+    expect('04/06/2022'.format_date_time('%A, %d %b %Y')).to eql 'Saturday, 04 Jun 2022'
+  end
+
+  it 'returns translated formatted date' do
+    expect('04/06/2022'.format_date_time(:abbrev)).to eql 'Jun 04, 2022'
+  end
+end

data/spec/testcentricity_web/page_object_spec.rb

@@ -0,0 +1,90 @@
+# frozen_string_literal: true
+
+describe TestCentricity::PageObject, required: true do
+  before :context do
+    @test_page = TestPage.new
+  end
+
+  context 'page object traits' do
+    it 'returns page name' do
+      expect(@test_page.page_name).to eq('Basic Test Page')
+    end
+
+    it 'returns page url' do
+      expect(@test_page.page_url).to eq('/basic_test_page.html')
+    end
+
+    it 'returns page locator' do
+      expect(@test_page.page_locator).to eq('form#HTMLFormElements')
+    end
+
+    it 'determines if page is secure' do
+      allow(@test_page).to receive(:secure?).and_return(false)
+      expect(@test_page.secure?).to eq(false)
+    end
+
+    it 'should display the title of the page' do
+      allow(@test_page).to receive(:title).and_return('I am the title of a page')
+      expect(@test_page.title).to eql 'I am the title of a page'
+    end
+
+    it 'determines if page is secure' do
+      allow(@test_page).to receive(:secure?).and_return(false)
+      expect(@test_page.secure?).to eq(false)
+    end
+
+    it 'responds to open_portal' do
+      expect(@test_page).to respond_to(:open_portal)
+    end
+
+    it 'responds to load_page' do
+      expect(@test_page).to respond_to(:load_page)
+    end
+
+    it 'responds to verify_page_exists' do
+      expect(@test_page).to respond_to(:verify_page_exists)
+    end
+
+    it 'responds to exists?' do
+      expect(@test_page).to respond_to(:exists?)
+    end
+  end
+
+  context 'page object with UI elements' do
+    it 'responds to element' do
+      expect(@test_page).to respond_to(:element1)
+    end
+
+    it 'responds to button' do
+      expect(@test_page).to respond_to(:button1)
+    end
+
+    it 'responds to textfield' do
+      expect(@test_page).to respond_to(:field1)
+    end
+
+    it 'responds to link' do
+      expect(@test_page).to respond_to(:link1)
+    end
+
+    it 'responds to range' do
+      expect(@test_page).to respond_to(:range1)
+    end
+
+    it 'responds to image' do
+      expect(@test_page).to respond_to(:image1)
+    end
+
+    it 'responds to radio' do
+      expect(@test_page).to respond_to(:radio1)
+    end
+
+    it 'responds to checkbox' do
+      expect(@test_page).to respond_to(:check1)
+    end
+
+    it 'responds to section' do
+      expect(@test_page).to respond_to(:section1)
+    end
+  end
+end

data/spec/testcentricity_web/section_object_spec.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+describe TestCentricity::PageSection, required: true do
+  before :context do
+    @test_page = TestPage.new
+    @test_section = @test_page.section1
+  end
+
+  context 'section object traits' do
+    it 'returns section name' do
+      expect(@test_section.section_name).to eq('Basic Test Section')
+    end
+
+    it 'returns section locator' do
+      expect(@test_section.get_locator).to eq('div#section')
+    end
+
+    it 'returns class' do
+      expect(@test_section.class).to eql TestSection
+    end
+
+    it 'returns css locator type' do
+      expect(@test_section.get_locator_type).to eql :css
+    end
+
+    it 'registers with type section' do
+      expect(@test_section.get_object_type).to eql :section
+    end
+
+    it 'returns parent list object' do
+      expect(@test_section.get_parent_list).to eql nil
+    end
+  end
+
+  context 'section object with UI elements' do
+    it 'responds to element' do
+      expect(@test_section).to respond_to(:element1)
+    end
+
+    it 'responds to button' do
+      expect(@test_section).to respond_to(:button1)
+    end
+
+    it 'responds to textfield' do
+      expect(@test_section).to respond_to(:field1)
+    end
+
+    it 'responds to link' do
+      expect(@test_section).to respond_to(:link1)
+    end
+
+    it 'responds to range' do
+      expect(@test_section).to respond_to(:range1)
+    end
+
+    it 'responds to image' do
+      expect(@test_section).to respond_to(:image1)
+    end
+
+    it 'responds to radio' do
+      expect(@test_section).to respond_to(:radio1)
+    end
+
+    it 'responds to checkbox' do
+      expect(@test_section).to respond_to(:check1)
+    end
+
+    it 'responds to section' do
+      expect(@test_section).to respond_to(:section2)
+    end
+  end
+end

data/spec/testcentricity_web/version_spec.rb

@@ -0,0 +1,7 @@
+# frozen_string_literal: true
+
+describe 'TestCentricityWeb::VERSION', required: true do
+  subject { TestCentricityWeb::VERSION }
+
+  it { is_expected.to be_truthy }
+end

data/spec/testcentricity_web/webdriver_connect/grid_webdriver_spec.rb

@@ -0,0 +1,72 @@
+# frozen_string_literal: true
+
+describe TestCentricity::WebDriverConnect, grid: true do
+  before(:context) do
+    # instantiate remote test environment
+    @environs ||= EnvironData
+    @environs.find_environ('REMOTE', :yaml)
+    ENV['SELENIUM'] = 'remote'
+    endpoint = 'http://localhost:4444/wd/hub'
+    ENV['REMOTE_ENDPOINT'] = endpoint
+    # wait for Dockerized Selenium grid to be running
+    20.downto(0) do |interval|
+      begin
+        response = HTTParty.get("#{endpoint}/status")
+        break if response.body.include?('Selenium Grid ready')
+      rescue
+        if interval == 0
+          raise 'Selenium Grid is not running.'
+        else
+          sleep(1)
+        end
+      end
+    end
+  end
+
+  context 'grid web browser instances' do
+    it 'connects to a grid hosted Firefox browser' do
+      ENV['WEB_BROWSER'] = 'firefox'
+      WebDriverConnect.initialize_web_driver
+      verify_grid_browser(browser = :firefox, platform = :desktop)
+    end
+
+    it 'connects to a grid hosted Chrome browser' do
+      ENV['WEB_BROWSER'] = 'chrome'
+      WebDriverConnect.initialize_web_driver
+      Browsers.suppress_js_leave_page_modal
+      verify_grid_browser(browser = :chrome, platform = :desktop)
+    end
+
+    it 'connects to a grid hosted Edge browser' do
+      ENV['WEB_BROWSER'] = 'edge'
+      WebDriverConnect.initialize_web_driver
+      Browsers.suppress_js_alerts
+      verify_grid_browser(browser = :edge, platform = :desktop)
+    end
+
+    it 'connects to a grid hosted emulated mobile web browser' do
+      ENV['WEB_BROWSER'] = 'ipad_pro_12_9'
+      ENV['HOST_BROWSER'] = 'chrome'
+      ENV['ORIENTATION'] = 'portrait'
+      WebDriverConnect.initialize_web_driver
+      Browsers.set_device_orientation('landscape')
+      verify_grid_browser(browser = :ipad_pro_12_9, platform = :mobile)
+    end
+  end
+
+  after(:each) do
+    $server.stop if Environ.driver == :appium && $server.running?
+    Capybara.current_session.quit
+    Environ.session_state = :quit
+  end
+
+  def verify_grid_browser(browser, platform)
+    expect(Environ.browser).to eq(browser)
+    expect(Environ.platform).to eq(platform)
+    expect(Environ.headless).to eq(false)
+    expect(Environ.session_state).to eq(:running)
+    expect(Environ.driver).to eq(:webdriver)
+    expect(Environ.device).to eq(:web)
+    expect(Environ.grid).to eq(:selenium_grid)
+  end
+end

data/spec/testcentricity_web/webdriver_connect/local_webdriver_spec.rb

@@ -0,0 +1,86 @@
+# frozen_string_literal: true
+
+describe TestCentricity::WebDriverConnect, required: true do
+  before(:context) do
+    # instantiate local test environment
+    @environs ||= EnvironData
+    @environs.find_environ('LOCAL', :yaml)
+    ENV['SELENIUM'] = ''
+  end
+
+  context 'local web browser instances' do
+    it 'connects to a local Firefox browser' do
+      ENV['WEB_BROWSER'] = 'firefox'
+      WebDriverConnect.initialize_web_driver
+      verify_local_browser(browser = :firefox, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local Safari browser' do
+      ENV['WEB_BROWSER'] = 'safari'
+      WebDriverConnect.initialize_web_driver
+      verify_local_browser(browser = :safari, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local Chrome browser' do
+      ENV['WEB_BROWSER'] = 'chrome'
+      WebDriverConnect.initialize_web_driver
+      Browsers.suppress_js_leave_page_modal
+      verify_local_browser(browser = :chrome, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local Edge browser' do
+      ENV['WEB_BROWSER'] = 'edge'
+      WebDriverConnect.initialize_web_driver
+      Browsers.suppress_js_alerts
+      verify_local_browser(browser = :edge, platform = :desktop, headless = false)
+    end
+
+    it 'connects to a local emulated mobile web browser' do
+      ENV['WEB_BROWSER'] = 'ipad_pro_12_9'
+      ENV['HOST_BROWSER'] = 'chrome'
+      ENV['ORIENTATION'] = 'portrait'
+      WebDriverConnect.initialize_web_driver
+      Browsers.set_device_orientation('landscape')
+      verify_local_browser(browser = :ipad_pro_12_9, platform = :mobile, headless = false)
+      expect(Environ.browser_size).to eq([1366, 1024])
+    end
+  end
+
+  context 'local headless browser instances' do
+    it 'connects to a local headless Chrome browser' do
+      ENV['WEB_BROWSER'] = 'chrome_headless'
+      WebDriverConnect.initialize_web_driver
+      Browsers.maximize_browser
+      verify_local_browser(browser = :chrome_headless, platform = :desktop, headless = true)
+    end
+
+    it 'connects to a local headless Edge browser' do
+      ENV['WEB_BROWSER'] = 'edge_headless'
+      WebDriverConnect.initialize_web_driver
+      Browsers.refresh_browser
+      verify_local_browser(browser = :edge_headless, platform = :desktop, headless = true)
+    end
+
+    it 'connects to a local headless Firefox browser' do
+      ENV['WEB_BROWSER'] = 'firefox_headless'
+      WebDriverConnect.initialize_web_driver
+      Browsers.delete_all_cookies
+      verify_local_browser(browser = :firefox_headless, platform = :desktop, headless = true)
+    end
+  end
+
+  after(:each) do
+    Capybara.current_session.quit
+    Environ.session_state = :quit
+  end
+
+  def verify_local_browser(browser, platform, headless)
+    expect(Environ.browser).to eq(browser)
+    expect(Environ.platform).to eq(platform)
+    expect(Environ.headless).to eq(headless)
+    expect(Environ.session_state).to eq(:running)
+    expect(Environ.driver).to eq(:webdriver)
+    expect(Environ.device).to eq(:web)
+    expect(Environ.is_web?).to eq(true)
+  end
+end

data/spec/testcentricity_web/webdriver_connect/mobile_webdriver_spec.rb

@@ -0,0 +1,65 @@
+# frozen_string_literal: true
+
+describe TestCentricity::WebDriverConnect, mobile: true do
+  before(:context) do
+    # instantiate local test environment
+    @environs ||= EnvironData
+    @environs.find_environ('LOCAL', :yaml)
+    ENV['SELENIUM'] = ''
+    ENV['WEB_BROWSER'] = 'appium'
+    ENV['DEVICE_TYPE'] = 'tablet'
+    # start Appium server
+    $server = TestCentricity::AppiumServer.new
+    $server.start
+  end
+
+  context 'Mobile device simulator' do
+    it 'connects to iOS Simulator' do
+      ENV['AUTOMATION_ENGINE'] = 'XCUITest'
+      ENV['APP_PLATFORM_NAME'] = 'ios'
+      ENV['APP_BROWSER'] = 'Safari'
+      ENV['APP_VERSION'] = '15.4'
+      ENV['APP_DEVICE'] = 'iPad Pro (12.9-inch) (5th generation)'
+      WebDriverConnect.initialize_web_driver
+      expect(Environ.browser).to eq(:appium)
+      expect(Environ.platform).to eq(:mobile)
+      expect(Environ.headless).to eq(false)
+      expect(Environ.session_state).to eq(:running)
+      expect(Environ.driver).to eq(:appium)
+      expect(Environ.device).to eq(:simulator)
+      expect(Environ.device_name).to eq('iPad Pro (12.9-inch) (5th generation)')
+      expect(Environ.device_os).to eq(:ios)
+      expect(Environ.device_type).to eq(:tablet)
+      expect(Environ.device_os_version).to eq('15.4')
+      expect(Environ.is_ios?).to eq(true)
+    end
+
+    it 'connects to Android Simulator' do
+      ENV['APP_PLATFORM_NAME'] = 'Android'
+      ENV['APP_BROWSER'] = 'Chrome'
+      ENV['APP_VERSION'] = '12.0'
+      ENV['APP_DEVICE'] = 'Pixel_C_API_31'
+      WebDriverConnect.initialize_web_driver
+      expect(Environ.browser).to eq(:appium)
+      expect(Environ.platform).to eq(:mobile)
+      expect(Environ.headless).to eq(false)
+      expect(Environ.session_state).to eq(:running)
+      expect(Environ.driver).to eq(:appium)
+      expect(Environ.device).to eq(:simulator)
+      expect(Environ.device_name).to eq('Pixel_C_API_31')
+      expect(Environ.device_os).to eq(:android)
+      expect(Environ.device_type).to eq(:tablet)
+      expect(Environ.device_os_version).to eq('12.0')
+      expect(Environ.is_android?).to eq(true)
+    end
+  end
+
+  after(:each) do
+    Capybara.current_session.quit
+    Environ.session_state = :quit
+  end
+
+  after(:context) do
+    $server.stop if Environ.driver == :appium && $server.running?
+  end
+end

data/test_site/basic_test_page.html

@@ -15,11 +15,44 @@
             text-align: left;
             padding: 8px;
         }
+        body {
+            margin: 0;
+            font-family: Arial, Helvetica, sans-serif;
+        }
+        .topnav {
+            overflow: hidden;
+            background-color: #333;
+        }
+        .topnav a {
+            float: left;
+            color: #f2f2f2;
+            text-align: center;
+            padding: 12px 14px;
+            text-decoration: none;
+            font-size: 15px;
+        }
+        .topnav a:hover {
+            background-color: #ddd;
+            color: black;
+        }
+        .topnav a.active {
+            background-color: #04AA6D;
+            color: white;
+        }
     </style>
 </head>
     <body>
         <div class="page-body">
-            <h1>Basic HTML Form Example</h1>
+            <h2 id="header">Basic HTML Form</h2>
+
+            <div id="nav_bar" class="topnav">
+                <a id="form_link" class="active" href="#">Basic HTML Form</a>
+                <a id="media_link" href="media_page.html">Media</a>
+                <a id="indexed_sections_link" href="indexed_sections_page.html">Indexed Sections</a>
+                <a id="custom_controls_link" href="custom_controls_page.html">Custom Controls</a>
+            </div>
+
+
             <div class="centered">
                 <form name="HTMLFormElements" id="HTMLFormElements">
                     <table border="1" cellpadding="5">
@@ -132,6 +165,23 @@
                             </td>
                         </tr>
 
+                        <tr>
+                            <td>
+                                <label id="links">Links:</label>
+                                <ul id="links_list">
+                                    <li>
+                                        <a id="link1" href="media_page.html">Open Media Page in same window/tab</a>
+                                    </li>
+                                    <li>
+                                        <a id="link2" href="media_page.html" target="_blank">Open Media Page in a new window/tab</a>
+                                    </li>
+                                    <li>
+                                        <a id="link3" role="link" aria-disabled="true">Disabled Link</a>
+                                    </li>
+                                </ul>
+                            </td>
+                        </tr>
+
                         <tr>
                             <td>
                                 <label for="table">Table:</label>