Web Element Wrapper

Overview

WebElementWrapper provides methods for interacting with located elements. It operates on the currently active element set by find_element() or find_elements().

The global instance web_element_wrapper is imported from je_web_runner.

Basic Interactions

from je_web_runner import web_element_wrapper

web_element_wrapper.click_element()                     # Click element
web_element_wrapper.input_to_element("Hello World")     # Type text
web_element_wrapper.clear()                             # Clear content
web_element_wrapper.submit()                            # Submit form

Attribute and Property Inspection

web_element_wrapper.get_attribute("href")        # Get HTML attribute
web_element_wrapper.get_property("checked")      # Get JS property
web_element_wrapper.get_dom_attribute("data-id")  # Get DOM attribute

State Checks

web_element_wrapper.is_displayed()    # Check visibility
web_element_wrapper.is_enabled()      # Check if enabled
web_element_wrapper.is_selected()     # Check if selected (checkbox/radio)

CSS Property

web_element_wrapper.value_of_css_property("color")

Element Screenshot

web_element_wrapper.screenshot("element")  # Saves as element.png

Switching Elements

When find_elements() returns multiple elements, use change_web_element() to switch the active element:

# After find_elements, switch to the 3rd element (index 2)
web_element_wrapper.change_web_element(2)
web_element_wrapper.click_element()

Element Validation

Validate element properties against expected values:

web_element_wrapper.check_current_web_element({
    "tag_name": "input",
    "enabled": True
})

Key Attributes

Attribute	Type	Description
`current_web_element`	`WebElement \| None`	Currently active element
`current_web_element_list`	`List[WebElement] \| None`	List of found elements (from `find_elements`)

Methods Reference

Method	Parameters	Description
`click_element()`		Click the current element
`input_to_element()`	`input_value: str`	Type text into the element
`clear()`		Clear element content
`submit()`		Submit the form
`get_attribute()`	`name: str`	Get HTML attribute value
`get_property()`	`name: str`	Get JavaScript property value
`get_dom_attribute()`	`name: str`	Get DOM attribute value
`is_displayed()`		Check if element is visible
`is_enabled()`		Check if element is enabled
`is_selected()`		Check if element is selected
`value_of_css_property()`	`property_name: str`	Get CSS property value
`screenshot()`	`filename: str`	Take element screenshot
`change_web_element()`	`element_index: int`	Switch active element by index
`check_current_web_element()`	`check_dict: dict`	Validate element properties
`get_select()`		Get Select object for dropdown