Retrieves WebDriver or WebElement from wrapped object:

>>> isinstance(br.unwrap, WebElement)
True

find_element_by_xpath(“./parent::node()”):

>>> price = br.by_tag("th", "Price").parent.by_tag("td").text

Returns window.performance wrapped object:

>>> performance = br.performance
>>> timing = performance.timing
>>> navigation = performance.navigation
>>> timing.loadEventEnd
1358319427476

Convert wrapped WebElement to raw Select object:

>>> br.by_id('select_button').to_select.select_by_visible_text("hoge")

select method returns the same as below:

>>> br.select(id = 'select_button').select_by_visible_text("hoge")

Returns Alert(switch_to_alert()) object:

>>> br.alert.accept()

Returns current_url after loading page body:

>>> br.current_url

Accessor for _timeout property:

>>> br.timeout
5
>>> br.timeout = 10
>>> br.timeout
10

Accessor for _silent property:

# default
>>> br.by_id("Hoge")
Traceback (most recent call last):
    ...
NoSuchElementException:...
>>> br.silent = True
>>> br.by_id("Hoge") is None
True

Shortcut to get_attribute:

>>> br.attr('href')

Continue to polling until timeout or element is displayed and clickable:

>>> br.button("Send").click()

equivalent to javascript’s scrollTo:

>>> br.scrollTo(0, 100)

equivalent to javascript’s scrollBy:

>>> br.scrollBy(10, 10)

find elements by jq_identifier and retrieve its first element and invoke scrollIntoView to it:

>>> var element = $('#hoge');
>>> element && element.scrollIntoView(true)

second argument is passed as javascript’s boolean to scrollIntoView:

>>> br.scrollIntoView('#hoge', False)

See source:

>>> br.waitfor("xpath", "//input[@type='submit']")

find_element_by_xpath(target, timeout):

>>> buttons = br.xpath("//input[@type='submit' or @type='button']", eager=True)

find_element_by_css_selector(target, timeout):

>>> [li.text for li in br.css("ul li")]

Returns specified tagged element with specified attributes optionally.:

>>> br.by_tag("link", rel="stylesheet")

similar to find_element_by_link_text or find_element_by_partial_link_text, but this method can be applicable to any tag:

>>> br.by_text("Go back to Top Page", "a")

find_element_by_class_name(target, timeout):

>>> br.by_class("colored")

find_element_by_id(target, timeout):

>>> br.by_id("main_contents")

find_element_by_name(target, timeout):

>>> br.by_name("page_password")

find_element_by_link_text(target, timeout). if partial=True, then find_element_by_partial_link_text:

>>> br.by_linktxt("Go back to", partial=True)

find_element_by_xpath(“//a”, timeout). if partialurl was given, search ‘a’ tag which href contains partialurl:

>>> phplinks = br.href(".php", eager=True)

find_elements_by_xpath(“//img”, timeout):

>>> br.img(alt="I am sorry", ext="sorry.gif")

find_element_by_xpath(“//input[@type=’submit’ or @type=’button’ and @value=’{0}’]|.//button[text()=’{0}’]”.format(value), timeout):

>>> br.button("Send this form").click()

Returns ‘input’ element type=’checkbox’:

>>> br.checkbox(name='checked_value', id='hoge')

Retuns ‘input’ element type=’radio’.:

>>> br.radio(name='hoge', id='fuga').click()

Returns Select(self.by_tag(“select”, eager, timeout, **attributes) or their wrapped SeleniumContainerWrapper:

>>> br.select(name="hoge").select_by_index(1)
>>> [select.is_multiple for select in br.select(eager=True, name="hoge")]

Returns length of wrapped iterable:

>>> br.img(eager=True).size

Returns random.sample(self._iterable, size):

>>> br.img(eager=True).sample(10)

Returns random.choice(self._iterable):

>>> br.img(eager=True).choice()