Scrolling

• scroll_browser

Misc

• get_page_source

• screenshot

• save_page_source

Waiting

• wait_for_url

• wait_for_title

• wait_for_js

Finding

• is_text_on_page

Scrolling

• scroll_to_element

Selecting

• find_element

• find_elements

• get_element

• get_elements

• get_text

• get_value

• get_texts

Waiting

• wait_for

• wait_for_visible

• wait_for_invisible

• wait_for_all_invisible

• wait_for_clickable

• wait_for_selected

• wait_for_presence

• wait_for_opacity

• wait_for_text

• wait_for_text_in_value

• wait_for_value

• wait_for_ko

Interaction

• click

• click_all

• hover

• send_key

• clear

Forms

• fill

• fill_form

• set_value

• set_selectize

• set_select_by_value

• set_select_by_text

print(elemental.current_url())
# outputs 'http://someaddress.here/page.html'

elemental.click('#some-button') # Clicks a button.

elemental.js('console.log("I am executing JS on the page!");')

elem = elemental.find_element('#my-id') # Returns a selenium element object

elems = elemental.find_elements('.some-class') # Returns a list of selenium element objects

form_data = {
    '#username': 'person',
    '#password': 'somepass'
}
elemental.fill(form_data) # Fills a form. Takes a dict of CSS keys and values.

elemental.screenshot('/tmp/screenshot1.png')

BrowserStack example:

from WebElemental import Elemental
desired = {
    'browser': 'Edge',
    'browser_version': '13.0',
    'os': 'Windows',
    'os_version': '10',
    'resolution': '1440x900'
}
elemental = Elemental(desired_capabilities=desired,
               command_executor='http://USERNAME:API_KEY@hub.browserstack.com:80/wd/hub',
                             driver='Remote')
elemental.start()
elemental.go('http://google.com')
elemental.set_value('#lst-ib', 'WebElemental')

As you can see, there is almost no reason to ever interact with the selenium browser object directly. This is by design. If you ever find yourself needing to, it means that you have uncovered a need that was unanticipated by the initial design of this utility.

If you are reading this, you are a programmer so it would be nice if you made the method you require and sent a PR. The more people use and develop this framework, the better it will become.

So even though I don’t recommend using it, you still have access to the selenium browser object.

elemental.browser.find_elements_by_id('#some-id') # Use elemental.find_element instead.