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.
Recommendation Initial definition

Browser compatibility

Update compatibility data on GitHub
DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidEdge MobileFirefox for AndroidOpera for AndroidiOS SafariSamsung Internet
Basic supportChrome No support No
Notes
No support No
Notes
Notes To enable Chromium support, include {"goog:chromeOptions": {"w3c": true}} in the capabiliites when running the command.
Edge No support No
Notes
No support No
Notes
Notes The vendor-supported implementation for Edge is non-spec-conforming and incompatible.
Firefox Full support 55IE Full support 7Opera No support No
Notes
No support No
Notes
Notes To enable Chromium support, include {"goog:chromeOptions": {"w3c": true}} in the capabiliites when running the command.
Safari No support No
Notes
No support No
Notes
Notes The vendor-supported implementation for Safari is non spec-conforming and incompatible.
WebView Android No support No
Notes
No support No
Notes
Notes To enable Chromium support, include {"goog:chromeOptions": {"w3c": true}} in the capabiliites when running the command.
Chrome Android No support No
Notes
No support No
Notes
Notes To enable Chromium support, include {"goog:chromeOptions": {"w3c": true}} in the capabiliites when running the command.
Edge Mobile No support No
Notes
No support No
Notes
Notes The vendor-supported implementation for Edge is non-spec-conforming and incompatible.
Firefox Android No support NoOpera Android No support No
Notes
No support No
Notes
Notes To enable Chromium support, include {"goog:chromeOptions": {"w3c": true}} in the capabiliites when running the command.
Safari iOS No support No
Notes
No support No
Notes
Notes The vendor-supported implementation for Safari is non spec-conforming and incompatible.
Samsung Internet Android No support No
Notes
No support No
Notes
Notes The vendor-supported implementation for Samsung Internet is non-spec-conforming and incompatible.

Legend

Full support  
Full support
No support  
No support
See implementation notes.
See implementation notes.

See also

Document Tags and Contributors

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