Please check gitlab-tutorial

Skip to content

Dynamic Element Validation

We devised a solution to solve common test automation problems such as the dreaded NoSuchElementException.

Other problems that dynamic element validations solve are...

  • When we perform an action with the mouse, we expect something to occur.
  • When our test is navigating to (or from) a page, we ensure that we are on the page we expect before test continuation.

How it works

We interpret user actions on the page to have some sort of effect. These actions are

Navigation

When a page is navigated to, there are elements that always appear on the page unconditionally.

Dynamic element validation is instituted when using

Runtime::Browser.visit(:gitlab, Some::Page)

Clicks

When we perform a click within our tests, we expect something to occur. That something could be a component to now appear on the webpage, or the test to navigate away from the page entirely.

Dynamic element validation is instituted when using

click_element('my-element', Some::Page)

Required Elements

Definition

First it is important to define what a "required element" is.

A required element is a visible HTML element that appears on a UI component without any user input.

"Visible" can be defined as

  • Not having any CSS preventing its display, for example, display: none or width: 0px; height: 0px;
  • Being able to be interacted with by the user

"UI component" can be defined as

  • Anything the user sees
  • A button, a text field
  • A layer that sits atop the page

Application

Requiring elements is very easy. By adding required: true as a parameter to an element, you've now made it a requirement that the element appear on the page upon navigation.

Examples

Given ...

class MyPage < Page::Base
  view 'app/views/view.html.haml' do
    element 'my-element', required: true
    element 'another-element', required: true
    element 'conditional-element'
  end

  def open_layer
    click_element('my-element', Layer::MyLayer)
  end
end

class Layer < Page::Component
  view 'app/views/mylayer/layer.html.haml' do
    element 'message-content', required: true
  end
end

Navigating

Given the source ...

Runtime::Browser.visit(:gitlab, Page::MyPage)

execute_stuff

invokes GitLab QA to scan MyPage for my-element and another-element to be on the page before continuing to execute_stuff

Clicking

Given the source ...

def open_layer
  click_element('my-element', Layer::MyLayer)
end

invokes GitLab QA to ensure that message-content appears on the Layer upon clicking my-element.

This implies that the Layer is indeed rendered before we continue our test.