We're looking for a user researcher to understand the needs of developers and designers. Is this you or someone you know? Check out the post: https://mzl.la/2IGzdXS

Get Element Property

The Get Element Property command of the WebDriver API returns the property of the referenced web element. Given <input value=foo> where the user changes the value to bar, the returned property is bar rather than the initial value foo. This is equivalent to calling Element.getProperty on the element.

Syntax

Method URI template
GET /session/{session id}/element/{element id}/property/{name}

URL parameters

session id
Identifier of the session.
element id
Identifier of the web element to get the tag name of.
name
Identifier of the property of web element to get.

Errors

Session not created
Session does not exist.
No such window
The window object has been discarded, indicating that the tab or window has been closed.
Unexpected alert open
A user prompt, such as window.alert, blocks execution of command until it is dealt with.

Examples

Python:

import urllib

from selenium import webdriver


def inline(doc):
    return "data:text/html;charset=utf-8,{}".format(urllib.quote(doc))


session = webdriver.Firefox()
session.get(inline("<input value=foo>"))
textbox = driver.find_element_by_tag_name("input")
textbox.send_keys("bar")

print(text_box.get_attribute("value"))
print(text_box.get_property("value"))

Output:

foo
bar

Specifications

Specification Status Comment
WebDriver
The definition of 'Get Element Property' in that specification.
Candidate Recommendation Initial definition

Browser compatibility

FeatureChromeEdgeFirefoxInternet ExplorerOperaSafari
Basic support No1 No2557 No1 No3
FeatureAndroid webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
Basic support No1 No1 No2 No No1 No3 No4

1. To enable Chromium support, include {"goog:chromeOptions": {"w3c": true}} in the capabiliites when running the command.

2. The vendor-supported implementation for Edge is non-spec-conforming and incompatible.

3. The vendor-supported implementation for Safari is non spec-conforming and incompatible.

4. The vendor-supported implementation for Samsung Internet is non-spec-conforming and incompatible.

See also

Document Tags and Contributors

Contributors to this page: ato, fscholz, automatedtester
Last updated by: ato,