Information about web elements

What you can learn about an element.

There are a number of details you can query about a specific element.

Is Displayed

This method is used to check if the connected Element is displayed on a webpage. Returns a Boolean value, True if the connected element is displayed in the current browsing context else returns false.

This functionality is mentioned in, but not defined by the w3c specification due to the impossibility of covering all potential conditions. As such, Selenium cannot expect drivers to implement this functionality directly, and now relies on executing a large JavaScript function directly. This function makes many approximations about an element’s nature and relationship in the tree to return a value.

# Navigate to the url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

# Get boolean value for is element display
is_email_visible = driver.find_element(By.NAME, "email_input").is_displayed()
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
 //navigates to url
 driver.get("https://www.selenium.dev/selenium/web/inputs.html")

 //returns true if element is displayed else returns false
 val flag = driver.findElement(By.name("email_input")).isDisplayed()

Is Enabled

This method is used to check if the connected Element is enabled or disabled on a webpage. Returns a boolean value, True if the connected element is enabled in the current browsing context else returns false.

    # Navigate to url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

    # Returns true if element is enabled else returns false
value = driver.find_element(By.NAME, 'button_input').is_enabled()
  
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
 //navigates to url
 driver.get("https://www.selenium.dev/selenium/web/inputs.html")

 //returns true if element is enabled else returns false
 val attr = driver.findElement(By.name("button_input")).isEnabled()

Is Selected

This method determines if the referenced Element is Selected or not. This method is widely used on Check boxes, radio buttons, input elements, and option elements.

Returns a boolean value, True if referenced element is selected in the current browsing context else returns false.

    # Navigate to url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

    # Returns true if element is checked else returns false
value = driver.find_element(By.NAME, "checkbox_input").is_selected()
  
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
 //navigates to url
 driver.get("https://www.selenium.dev/selenium/web/inputs.html")

 //returns true if element is checked else returns false
 val attr =  driver.findElement(By.name("checkbox_input")).isSelected()

Tag Name

It is used to fetch the TagName of the referenced Element which has the focus in the current browsing context.

    # Navigate to url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

    # Returns TagName of the element
attr = driver.find_element(By.NAME, "email_input").tag_name
  
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
 //navigates to url
 driver.get("https://www.selenium.dev/selenium/web/inputs.html")

 //returns TagName of the element
 val attr =  driver.findElement(By.name("email_input")).getTagName()

Size and Position

It is used to fetch the dimensions and coordinates of the referenced element.

The fetched data body contain the following details:

  • X-axis position from the top-left corner of the element
  • y-axis position from the top-left corner of the element
  • Height of the element
  • Width of the element
    # Navigate to url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

    # Returns height, width, x and y coordinates referenced element
res = driver.find_element(By.NAME, "range_input").rect
  
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
// Navigate to url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

// Returns height, width, x and y coordinates referenced element
val res = driver.findElement(By.name("range_input")).rect

// Rectangle class provides getX,getY, getWidth, getHeight methods
println(res.getX())

Get CSS Value

Retrieves the value of specified computed style property of an element in the current browsing context.

    # Navigate to Url
driver.get('https://www.selenium.dev/selenium/web/colorPage.html')

    # Retrieves the computed style property 'color' of linktext
cssValue = driver.find_element(By.ID, "namedColor").value_of_css_property('background-color')
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
// Navigate to Url
driver.get("https://www.selenium.dev/selenium/web/colorPage.html")

// Retrieves the computed style property 'color' of linktext
val cssValue = driver.findElement(By.id("namedColor")).getCssValue("background-color")

Text Content

Retrieves the rendered text of the specified element.

    # Navigate to url
driver.get("https://www.selenium.dev/selenium/web/linked_image.html")

    # Retrieves the text of the element
text = driver.find_element(By.ID, "justanotherlink").text
  
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
// Navigate to URL
driver.get("https://www.selenium.dev/selenium/web/linked_image.html")

// retrieves the text of the element
val text = driver.findElement(By.id("justanotherlink")).getText()

Fetching Attributes or Properties

Fetches the run time value associated with a DOM attribute. It returns the data associated with the DOM attribute or property of the element.

# Navigate to the url
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

# Identify the email text box
email_txt = driver.find_element(By.NAME, "email_input")

# Fetch the value property associated with the textbox
value_info = email_txt.get_attribute("value")
  
  




  




  













  <div class="alert alert-primary bg-transparent col-10 ps-lg-5 m-4" role="alert">
    <h4 class="alert-heading"><code>SELENIUM_CI_TOKEN</code> not set</h4>
    <p>
      If you want to render content fetched from the GitHub API, please create a 
      <a 
        href="https://docs.github.com/en/authentication/keeping-your-account-and-data-secure/creating-a-personal-access-token"
        target="_blank"
      >
      personal access token
      </a> and set it as an environment variable named <code>SELENIUM_CI_TOKEN</code>. More information about token scopes can
      be seen at 
      <a 
        href="https://docs.github.com/en/developers/apps/building-oauth-apps/scopes-for-oauth-apps#available-scopes" 
        target="_blank"
      >
      available scopes GitHub docs
      </a>
    </p>
  </div>
// Navigate to URL
driver.get("https://www.selenium.dev/selenium/web/inputs.html")

//fetch the value property associated with the textbox
val attr = driver.findElement(By.name("email_input")).getAttribute("value")
Last modified August 8, 2024: added csharp code and update documents (#1838)[deploy site] (268aa6fba)