Class Select

java/src/org/openqa/selenium/support/ui/Select.java:31–435

Models a SELECT tag, providing helper methods to select and deselect options.

/** Models a SELECT tag, providing helper methods to select and deselect options. */
public class Select implements ISelect, WrapsElement {

  private final WebElement element;
  private final boolean isMulti;

  /**
   * Constructor. A check is made that the given element is, indeed, a SELECT tag. If it is not,
   * then an UnexpectedTagNameException is thrown.
   *
   * @param element SELECT element to wrap
   * @throws UnexpectedTagNameException when element is not a SELECT
   */
  public Select(WebElement element) {
    String tagName = element.getTagName();

    if (!"select".equalsIgnoreCase(tagName)) {
      throw new UnexpectedTagNameException("select", tagName);
    }

    this.element = element;

    String value = element.getDomAttribute("multiple");

    // The atoms normalize the returned value, but check for "false"
    isMulti = (value != null && !"false".equals(value));
  }

  @Override
  public WebElement getWrappedElement() {
    return element;
  }

  /**
   * @return Whether this select element support selecting multiple options at the same time? This
   *     is done by checking the value of the "multiple" attribute.
   */
  @Override
  public boolean isMultiple() {
    return isMulti;
  }

  /**
   * @return This is done by checking the value of attributes in "visibility", "display", "opacity"
   *     Return false if visibility is set to 'hidden', display is 'none', or opacity is 0 or 0.0.
   */
  private boolean hasCssPropertyAndVisible(WebElement webElement) {
    Set<String> cssValueCandidates = Set.of("hidden", "none", "0", "0.0");
    List<String> cssPropertyCandidates = List.of("visibility", "display", "opacity");

    for (String property : cssPropertyCandidates) {
      String cssValue = webElement.getCssValue(property);
      if (cssValueCandidates.contains(cssValue)) return false;
    }

    return true;
  }

  /**