pageobject package¶

Submodules¶

pageobject.page module¶

class pageobject.page.Page(url=None, locator='', chain=True, webdriver=None, name=None)¶

Bases: pageobject.singlepageobjectbase.SinglePageObjectBase

Web page class.

Create a page and its children page objects.

Parameters:

url (str) – Url of the page. Must start with a valid protocol (like http)
locator (str) – Xpath describing location of the page object in the DOM.
chain (bool) – Determines whether to chain locator to its parent.
webdriver (selenium.webdriver.Remote instance or None) – Only needs to be provided if the page is also a root page object.
name (str) – Name used when the page is a root.

Example usage:

from pageobject import Page
from selenium import webdriver
wd = webdriver.Chrome()
python_org_page = Page(url="http://www.python.org", webdriver=wd)

DEFAULT_ROOT_NAME = 'page'¶

load(log=True)¶

Load the web page.

Parameters:	log (bool) – whether to log or not (defualt is True)
Returns:	self
Return type:	PageObjectBase instance

requested_url¶

Return requested url, None by default.

May be overridden to take precedence over the url provided to constructor.

Returns:	requested url of the page
Return type:	str

pageobject.pageobject module¶

class pageobject.pageobject.PageObject(locator, chain=True, webdriver=None, name=None)¶

Bases: pageobject.singlepageobjectbase.SinglePageObjectBase

Main general-purpose page object class.

Create a page object and its children.

Parameters:	locator (str) – Xpath describing location of the page object in the DOM. chain (bool) – Determines whether to chain locator to its parent. webdriver (`selenium.webdriver.Remote` instance or None) – Only needs to be provided for root page object. name (str) – Name used when the page object is a root.
Example usage:

from pageobject import PageObject
top_panel = PageObject("//*[@class='topPanel']")

DEFAULT_POLL_INTERVAL = 0.25¶

DEFAULT_ROOT_NAME = 'page_object'¶

DEFAULT_WAIT_TIMEOUT = 60¶

NAME_SEPARATOR = '.'¶

children¶

Return dict of page object children.

Returns:	children of the page object
Return type:	`dict`

clear(log=True, press_enter=False)¶

Clear the page object.

Parameters:	log (bool) – whether to log or not (defualt is True) press_enter (bool) – whether to press enter key after the element is cleared (defualt is False)
Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

click()¶

Click the page object.

Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

default_locator¶

Return default locator, None by default.

May be overridden to take precedence over the locator provided to constructor.

Returns:	default locator
Return type:	None (default) or str (if overridden)

full_name¶

Return full name of the page object instance.

If parent exists, ask for its child full name, otherwiser use normal short name.

Returns:	Full name of the pge object.
Return type:	str

See also

_get_child_full_name()

get_attribute(attribute, log=True)¶

Return an attribute value of the page object.

Parameters:	attribute (str) – attribute name log (bool) – whether to log or not (default is True)
Returns:	attribute value
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

get_value()¶

Return value of the page object.

Returns:	value of the page object
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

init_children()¶

Initialize children of the page object.

Intended to be overridden by page objects containing other page objects.

Return type:	`None`

is_displayed(log=True)¶

Return True if page object is displayed, False otherwise.

Parameters:	log (bool) – whether to log or not (default is True)
Returns:	whether page object is displayed
Return type:	bool

is_enabled(log=True)¶

Return True if page object is enabled, False otherwise.

Parameters:	log (bool) – whether to log or not (defualt is True)
Returns:	whether page object is enabled
Return type:	bool

is_existing(log=True)¶

Return True if page object exists in the DOM, False otherwise.

Parameters:	log (bool) – whether to log or not (default is True)
Returns:	whether page object exists in the DOM
Return type:	bool

is_interactive(log=True)¶

Return True if page object is interactive, False otherwise.

Interactive means both displayed and enabled. This is called “clickable” in selenium, which may be misleading, as an element can be both displayed and enabled, but not really clickable, because another element may cover it and prevent it from receiving the click.

Parameters:	log (bool) – whether to log or not (defualt is True)
Returns:	whether page object is interactive
Return type:	bool

is_visible(log=True)¶: DEPRECATED! Use is_displayed command instead.

locator¶

Publicly exposed locator value.

Returns:	locator value
Return type:	str

logger¶

Return the logger object.

Returns:	standard logging module
Return type:	`logging`

move_to()¶

Move mouse over the page object.

Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

name¶

Return name of the page object instance.

If parent exists, ask for its child name, otherwise use the name provided to constructor. If that doesn’t exist either, use DEFAULT_ROOT_NAME.

Returns:	Name of the page object.
Return type:	str

parent¶

Return the parent of the page object.

Returns:	Parent page object.
Return type:	`pageobject.pageobjectbase.PageObjectBase` or None (default)

send_keys(keys, log=True)¶

Send keys to the page object.

Parameters:	keys (iterable of string type) – keys to send to the page object log (bool) – whether to log or not (default is True)
Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

set_value(value, press_enter=False)¶

Set value of the page object.

Parameters:	value (str) – value to set to the page object press_enter (bool) – whether to press enter key after setting the value (default is False)
Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

text¶

Return text of the page object.

Returns:	text of the page object
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

tree¶

Returns:	Hierarchical tree of page object and its descendants.
Return type:	dict

wait_for_enabled(timeout=None)¶: DEPRECATED! Use wait_until_enabled command instead.

wait_for_exist(timeout=None)¶: DEPRECATED! Use wait_until_existing command instead.

wait_for_interactive(timeout=None)¶: DEPRECATED! Use wait_until_interactive command instead.

wait_for_vanish(timeout=None)¶: DEPRECATED! Use wait_until_vanished command instead.

wait_for_visible(timeout=None)¶: DEPRECATED! Use wait_until_displayed command instead.

wait_until(func, func_args=[], func_kwargs={}, timeout=None, error_msg=None, reverse=False)¶

Wait until a condition is met.

Condition is an arbitrary function with optional args and kwargs that returns bool. If reverse=True, wait until the function returns False, otherwise wait until the function returns True (default).

Parameters:

func (function) – function returning bool that is repeatedly invoked until it returns correct value
func_args (list) – list of args to be passed to func
func_kwargs (dict) – dict of kwargs to be passed to func
timeout (int) – number of seconds to try to call func, if not provided, PageObject.DEFAULT_WAIT_TIMEOUT is used
error_msg (str) – error message to attach to the exception raised when the condition is not met in time
reverse (bool) – flag indicating whether to wait until the condition is True or False

Raises:

TimeoutException – if the condition is not met in time

wait_until_displayed(timeout=None)¶

Wait until page object to be displayed.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_enabled(timeout=None)¶

Wait until page object is enabled.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_existing(timeout=None)¶

Wait until page object is existing in the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_interactive(timeout=None)¶

Wait until page object is interactive.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_vanished(timeout=None)¶

Wait until page object vanishes from the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

webdriver¶

Return the instance of WebDriver.

If parent exists, use the webdriver property of the parent. Otherwise use the value provided to constructor.

Returns:	reference to the webdriver instance
Return type:	selenium.webdriver.Remote
Raises:	AssertionError – if the webdriver is not a valid WebDriver

webelement¶

Return a webelement instance.

Returns:	webelement instance
Return type:	`selenium.webdriver.remote.webelement.WebElement`
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

See also

selenium WebElement documentation (external link)

pageobject.pageobjectbase module¶

class pageobject.pageobjectbase.PageObjectBase¶

Bases: object

Abstract page object base class.

All the other classes inherit from this one.

DEFAULT_POLL_INTERVAL = 0.25¶

DEFAULT_ROOT_NAME = 'root'¶

DEFAULT_WAIT_TIMEOUT = 60¶

NAME_SEPARATOR = '.'¶

default_locator¶

Return default locator, None by default.

May be overridden to take precedence over the locator provided to constructor.

Returns:	default locator
Return type:	None (default) or str (if overridden)

full_name¶

Return full name of the page object instance.

If parent exists, ask for its child full name, otherwiser use normal short name.

Returns:	Full name of the pge object.
Return type:	str

See also

_get_child_full_name()

locator¶

Publicly exposed locator value.

Returns:	locator value
Return type:	str

logger¶

Return the logger object.

Returns:	standard logging module
Return type:	`logging`

name¶

Return name of the page object instance.

If parent exists, ask for its child name, otherwise use the name provided to constructor. If that doesn’t exist either, use DEFAULT_ROOT_NAME.

Returns:	Name of the page object.
Return type:	str

parent¶

Return the parent of the page object.

Returns:	Parent page object.
Return type:	`pageobject.pageobjectbase.PageObjectBase` or None (default)

tree¶

Returns:	Hierarchical tree of page object and its descendants.
Return type:	dict

webdriver¶

Return the instance of WebDriver.

If parent exists, use the webdriver property of the parent. Otherwise use the value provided to constructor.

Returns:	reference to the webdriver instance
Return type:	selenium.webdriver.Remote
Raises:	AssertionError – if the webdriver is not a valid WebDriver

pageobject.pageobjectlist module¶

class pageobject.pageobjectlist.PageObjectList(locator, chain=True, children_class=None, children_locator=None, count_locator=None)¶

Bases: pageobject.pageobjectlistbase.PageObjectListBase

Create page object list of children of the same type.

Parameters:

locator (str) – Xpath locator of children page objects for simple indexing of children in a one-level of nesting.
chain (bool) – Determines whether to chain locator to its parent.
children_class (PageObjectBase) – Class to use for instantiation of children page objects.
children_locator (str) – Locator of children page objects offering more control over what will be indexed, necessary for more deeply nested children.
count_locator (str) – Xpath determining the number of children, necessary for more deeply nested children.

children¶

Return list of children page objects.

Returns:	list of children page objects
Return type:	`list` of PageObjectBase instances

children_class¶

Return class to use for children instantiation.

Returns:	Class for children instantiation.
Return type:	PageObjectBase subclass

default_children_locator¶

Return defualt children locator, None by default.

May be overridden to take precedence over the children_locator provided to constructor.

Returns:	default children locator
Return type:	`None` (default) or `str` (if overridden)

default_count_locator¶

Return default count locator, None by default.

May be overridden to take precedence over the count_locator provided to constructor

Returns:	defualt count locator
Return type:	`None` (default) or `str` (if overridden)

pageobject.select module¶

class pageobject.select.Select(locator, chain=True, webdriver=None, name=None)¶

Bases: pageobject.pageobject.PageObject

Select page object class.

Extends PageObject class and attempts to delegate unrecognized attributes to selenium Select class.

See also

selenium Select class documentation (external link)

Create a page object and its children.

Parameters:	locator (str) – Xpath describing location of the page object in the DOM. chain (bool) – Determines whether to chain locator to its parent. webdriver (`selenium.webdriver.Remote` instance or None) – Only needs to be provided for root page object. name (str) – Name used when the page object is a root.
Example usage:

from pageobject import PageObject
top_panel = PageObject("//*[@class='topPanel']")

elem¶

Return select element to which to delegate webdriver methods.

Returns:	select webelement
Return type:	`selenium.webdriver.support.ui.Select` instance

class pageobject.select.WebDriverSelect(webelement)¶

Bases: selenium.webdriver.support.select.Select, object

Temporary abstract class.

This is a workaround for selenium.webdriver.support.ui.Select class not inheriting from object.

TODO: Get rid of this class when the below PR is merged: https://github.com/SeleniumHQ/selenium/pull/3067

Constructor. A check is made that the given element is, indeed, a SELECT tag. If it is not, then an UnexpectedTagNameException is thrown.

Args:	webelement - element SELECT element to wrap

Example:

from selenium.webdriver.support.ui import Select

Select(driver.find_element_by_tag_name(“select”)).select_by_index(2)

pageobject.singlepageobjectbase module¶

class pageobject.singlepageobjectbase.SinglePageObjectBase¶

Bases: pageobject.pageobjectbase.PageObjectBase

children¶

Return dict of page object children.

Returns:	children of the page object
Return type:	`dict`

get_attribute(attribute, log=True)¶

Return an attribute value of the page object.

Parameters:	attribute (str) – attribute name log (bool) – whether to log or not (default is True)
Returns:	attribute value
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

init_children()¶

Initialize children of the page object.

Intended to be overridden by page objects containing other page objects.

Return type:	`None`

is_existing(log=True)¶

Return True if page object exists in the DOM, False otherwise.

Parameters:	log (bool) – whether to log or not (default is True)
Returns:	whether page object exists in the DOM
Return type:	bool

text¶

Return text of the page object.

Returns:	text of the page object
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

wait_for_exist(timeout=None)¶: DEPRECATED! Use wait_until_existing command instead.

wait_for_vanish(timeout=None)¶: DEPRECATED! Use wait_until_vanished command instead.

wait_until(func, func_args=[], func_kwargs={}, timeout=None, error_msg=None, reverse=False)¶

Wait until a condition is met.

Condition is an arbitrary function with optional args and kwargs that returns bool. If reverse=True, wait until the function returns False, otherwise wait until the function returns True (default).

Parameters:

func (function) – function returning bool that is repeatedly invoked until it returns correct value
func_args (list) – list of args to be passed to func
func_kwargs (dict) – dict of kwargs to be passed to func
timeout (int) – number of seconds to try to call func, if not provided, PageObject.DEFAULT_WAIT_TIMEOUT is used
error_msg (str) – error message to attach to the exception raised when the condition is not met in time
reverse (bool) – flag indicating whether to wait until the condition is True or False

Raises:

TimeoutException – if the condition is not met in time

wait_until_existing(timeout=None)¶

Wait until page object is existing in the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_vanished(timeout=None)¶

Wait until page object vanishes from the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

webelement¶

Return a webelement instance.

Returns:	webelement instance
Return type:	`selenium.webdriver.remote.webelement.WebElement`
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

See also

selenium WebElement documentation (external link)

Module contents¶

pageobject‘s main module

class pageobject.PageObject(locator, chain=True, webdriver=None, name=None)¶

Bases: pageobject.singlepageobjectbase.SinglePageObjectBase

Main general-purpose page object class.

Create a page object and its children.

Parameters:	locator (str) – Xpath describing location of the page object in the DOM. chain (bool) – Determines whether to chain locator to its parent. webdriver (`selenium.webdriver.Remote` instance or None) – Only needs to be provided for root page object. name (str) – Name used when the page object is a root.
Example usage:

from pageobject import PageObject
top_panel = PageObject("//*[@class='topPanel']")

DEFAULT_POLL_INTERVAL = 0.25¶

DEFAULT_ROOT_NAME = 'page_object'¶

DEFAULT_WAIT_TIMEOUT = 60¶

NAME_SEPARATOR = '.'¶

_descendants¶

Return descendants of the page object.

Returns:	hierarchical tree of descendants of the page object
Return type:	`dict`

_get_child_full_name(child_po)¶

Return full name of a child page object.

Returns:	full name of a child page object
Return type:	`str`

_get_child_name(child_po)¶

Return name of a child page object.

Returns:	name of a child page object
Return type:	`str`

_locator¶

Returns:	Locator of the page object
Return type:	Locator instance

_locator_class¶

Returns:	locator class
Return type:	Locator

_locator_value¶

Returns:	processed locator value ready to be passed to a webdriver find method
Return type:	str

_log_id_long¶

Returns:	String identifying the page object by its full name and locator.
Return type:	str

_log_id_short¶

Returns:	String identifying the page object by its full name.
Return type:	str

_parent_locator¶

Return the locator of the parent page object.

Returns:	Locator of parent or None if parent does not exist
Return type:	Locator or None

_parent_locator_value¶

Returns:	value of the parent locator
Return type:	str

_provided_locator¶

Returns:	locator string provided either to the constructor or as an overridden default_locator property
Return type:	str

children¶

Return dict of page object children.

Returns:	children of the page object
Return type:	`dict`

clear(log=True, press_enter=False)¶

Clear the page object.

Parameters:	log (bool) – whether to log or not (defualt is True) press_enter (bool) – whether to press enter key after the element is cleared (defualt is False)
Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

click()¶

Click the page object.

Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

default_locator¶

Return default locator, None by default.

May be overridden to take precedence over the locator provided to constructor.

Returns:	default locator
Return type:	None (default) or str (if overridden)

full_name¶

Return full name of the page object instance.

If parent exists, ask for its child full name, otherwiser use normal short name.

Returns:	Full name of the pge object.
Return type:	str

See also

_get_child_full_name()

get_attribute(attribute, log=True)¶

Return an attribute value of the page object.

Parameters:	attribute (str) – attribute name log (bool) – whether to log or not (default is True)
Returns:	attribute value
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

get_value()¶

Return value of the page object.

Returns:	value of the page object
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

init_children()¶

Initialize children of the page object.

Intended to be overridden by page objects containing other page objects.

Return type:	`None`

is_displayed(log=True)¶

Return True if page object is displayed, False otherwise.

Parameters:	log (bool) – whether to log or not (default is True)
Returns:	whether page object is displayed
Return type:	bool

is_enabled(log=True)¶

Return True if page object is enabled, False otherwise.

Parameters:	log (bool) – whether to log or not (defualt is True)
Returns:	whether page object is enabled
Return type:	bool

is_existing(log=True)¶

Return True if page object exists in the DOM, False otherwise.

Parameters:	log (bool) – whether to log or not (default is True)
Returns:	whether page object exists in the DOM
Return type:	bool

is_interactive(log=True)¶

Return True if page object is interactive, False otherwise.

Interactive means both displayed and enabled. This is called “clickable” in selenium, which may be misleading, as an element can be both displayed and enabled, but not really clickable, because another element may cover it and prevent it from receiving the click.

Parameters:	log (bool) – whether to log or not (defualt is True)
Returns:	whether page object is interactive
Return type:	bool

is_visible(log=True)¶: DEPRECATED! Use is_displayed command instead.

locator¶

Publicly exposed locator value.

Returns:	locator value
Return type:	str

logger¶

Return the logger object.

Returns:	standard logging module
Return type:	`logging`

move_to()¶

Move mouse over the page object.

Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

name¶

Return name of the page object instance.

If parent exists, ask for its child name, otherwise use the name provided to constructor. If that doesn’t exist either, use DEFAULT_ROOT_NAME.

Returns:	Name of the page object.
Return type:	str

parent¶

Return the parent of the page object.

Returns:	Parent page object.
Return type:	`pageobject.pageobjectbase.PageObjectBase` or None (default)

send_keys(keys, log=True)¶

Send keys to the page object.

Parameters:	keys (iterable of string type) – keys to send to the page object log (bool) – whether to log or not (default is True)
Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

set_value(value, press_enter=False)¶

Set value of the page object.

Parameters:	value (str) – value to set to the page object press_enter (bool) – whether to press enter key after setting the value (default is False)
Returns:	self
Return type:	PageObjectBase instance
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

text¶

Return text of the page object.

Returns:	text of the page object
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

tree¶

Returns:	Hierarchical tree of page object and its descendants.
Return type:	dict

wait_for_enabled(timeout=None)¶: DEPRECATED! Use wait_until_enabled command instead.

wait_for_exist(timeout=None)¶: DEPRECATED! Use wait_until_existing command instead.

wait_for_interactive(timeout=None)¶: DEPRECATED! Use wait_until_interactive command instead.

wait_for_vanish(timeout=None)¶: DEPRECATED! Use wait_until_vanished command instead.

wait_for_visible(timeout=None)¶: DEPRECATED! Use wait_until_displayed command instead.

wait_until(func, func_args=[], func_kwargs={}, timeout=None, error_msg=None, reverse=False)¶

Wait until a condition is met.

Condition is an arbitrary function with optional args and kwargs that returns bool. If reverse=True, wait until the function returns False, otherwise wait until the function returns True (default).

Parameters:

func (function) – function returning bool that is repeatedly invoked until it returns correct value
func_args (list) – list of args to be passed to func
func_kwargs (dict) – dict of kwargs to be passed to func
timeout (int) – number of seconds to try to call func, if not provided, PageObject.DEFAULT_WAIT_TIMEOUT is used
error_msg (str) – error message to attach to the exception raised when the condition is not met in time
reverse (bool) – flag indicating whether to wait until the condition is True or False

Raises:

TimeoutException – if the condition is not met in time

wait_until_displayed(timeout=None)¶

Wait until page object to be displayed.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_enabled(timeout=None)¶

Wait until page object is enabled.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_existing(timeout=None)¶

Wait until page object is existing in the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_interactive(timeout=None)¶

Wait until page object is interactive.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_vanished(timeout=None)¶

Wait until page object vanishes from the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

webdriver¶

Return the instance of WebDriver.

If parent exists, use the webdriver property of the parent. Otherwise use the value provided to constructor.

Returns:	reference to the webdriver instance
Return type:	selenium.webdriver.Remote
Raises:	AssertionError – if the webdriver is not a valid WebDriver

webelement¶

Return a webelement instance.

Returns:	webelement instance
Return type:	`selenium.webdriver.remote.webelement.WebElement`
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

See also

selenium WebElement documentation (external link)

class pageobject.PageObjectList(locator, chain=True, children_class=None, children_locator=None, count_locator=None)¶

Bases: pageobject.pageobjectlistbase.PageObjectListBase

Create page object list of children of the same type.

Parameters:

locator (str) – Xpath locator of children page objects for simple indexing of children in a one-level of nesting.
chain (bool) – Determines whether to chain locator to its parent.
children_class (PageObjectBase) – Class to use for instantiation of children page objects.
children_locator (str) – Locator of children page objects offering more control over what will be indexed, necessary for more deeply nested children.
count_locator (str) – Xpath determining the number of children, necessary for more deeply nested children.

DEFAULT_POLL_INTERVAL = 0.25¶

DEFAULT_ROOT_NAME = 'root'¶

DEFAULT_WAIT_TIMEOUT = 60¶

NAME_SEPARATOR = '.'¶

_children_count¶

_children_locator_value¶

Returns:	processed children locator value ready to be passed to a webdriver find method
Return type:	str

_count_locator_value¶

Returns:	processed count locator value ready to be passed to a webdriver find method
Return type:	str

_descendants¶

Return descendants of the children_class dummy instance.

Returns:	hierarchical tree of descendants of the children_class dummy instance
Return type:	`dict`

_get_child_full_name(child_po)¶

Return indexed full name of a child page object.

Returns:	indexed full name of a child page object
Return type:	`str`

_get_child_name(child_po)¶

Return indexed name of a child page object.

Returns:	indexed name of a child page object
Return type:	`str`

_locator¶

Returns:	Locator of the page object
Return type:	Locator instance

_locator_class¶

Returns:	locator class
Return type:	Locator

_locator_value¶

Returns:	processed locator value ready to be passed to a webdriver find method
Return type:	str

_log_id_long¶

Returns:	String identifying the page object by its full name and locator.
Return type:	str

_log_id_short¶

Returns:	String identifying the page object by its full name.
Return type:	str

_parent_locator¶

Return the locator of the parent page object.

Returns:	Locator of parent or None if parent does not exist
Return type:	Locator or None

_parent_locator_value¶

Returns:	value of the parent locator
Return type:	str

_provided_children_locator¶

Returns:	children locator string provided either as an overridden default_children_locator or passed to the constructor
Return type:	str

_provided_count_locator¶

Returns:	count locator string provided either as an overridden default_count_locator or passed to the constructor
Return type:	str

_provided_locator¶

Returns:	locator string provided either to the constructor or as an overridden default_locator property
Return type:	str

children¶

Return list of children page objects.

Returns:	list of children page objects
Return type:	`list` of PageObjectBase instances

children_class¶

Return class to use for children instantiation.

Returns:	Class for children instantiation.
Return type:	PageObjectBase subclass

default_children_locator¶

Return defualt children locator, None by default.

May be overridden to take precedence over the children_locator provided to constructor.

Returns:	default children locator
Return type:	`None` (default) or `str` (if overridden)

default_count_locator¶

Return default count locator, None by default.

May be overridden to take precedence over the count_locator provided to constructor

Returns:	defualt count locator
Return type:	`None` (default) or `str` (if overridden)

default_locator¶

Return default locator, None by default.

May be overridden to take precedence over the locator provided to constructor.

Returns:	default locator
Return type:	None (default) or str (if overridden)

full_name¶

Return full name of the page object instance.

If parent exists, ask for its child full name, otherwiser use normal short name.

Returns:	Full name of the pge object.
Return type:	str

See also

_get_child_full_name()

index(value)¶

Return index of the first child containing the specified value.

Parameters:	value (str) – text value to look for
Returns:	index of the first child containing the specified value
Return type:	int
Raises:	ValueError – if the value is not found

locator¶

Publicly exposed locator value.

Returns:	locator value
Return type:	str

logger¶

Return the logger object.

Returns:	standard logging module
Return type:	`logging`

name¶

Return name of the page object instance.

If parent exists, ask for its child name, otherwise use the name provided to constructor. If that doesn’t exist either, use DEFAULT_ROOT_NAME.

Returns:	Name of the page object.
Return type:	str

parent¶

Return the parent of the page object.

Returns:	Parent page object.
Return type:	`pageobject.pageobjectbase.PageObjectBase` or None (default)

text_values¶

Return list of text values of PageObjectList children.

Returns:	index of the first child containing the specified value
Returns:	list of text values (innerHTML)
Return type:	list of str

tree¶

Returns:	Hierarchical tree of page object and its descendants.
Return type:	dict

webdriver¶

Return the instance of WebDriver.

If parent exists, use the webdriver property of the parent. Otherwise use the value provided to constructor.

Returns:	reference to the webdriver instance
Return type:	selenium.webdriver.Remote
Raises:	AssertionError – if the webdriver is not a valid WebDriver

class pageobject.Page(url=None, locator='', chain=True, webdriver=None, name=None)¶

Bases: pageobject.singlepageobjectbase.SinglePageObjectBase

Web page class.

Create a page and its children page objects.

Parameters:

url (str) – Url of the page. Must start with a valid protocol (like http)
locator (str) – Xpath describing location of the page object in the DOM.
chain (bool) – Determines whether to chain locator to its parent.
webdriver (selenium.webdriver.Remote instance or None) – Only needs to be provided if the page is also a root page object.
name (str) – Name used when the page is a root.

Example usage:

from pageobject import Page
from selenium import webdriver
wd = webdriver.Chrome()
python_org_page = Page(url="http://www.python.org", webdriver=wd)

DEFAULT_POLL_INTERVAL = 0.25¶

DEFAULT_ROOT_NAME = 'page'¶

DEFAULT_WAIT_TIMEOUT = 60¶

NAME_SEPARATOR = '.'¶

_descendants¶

Return descendants of the page object.

Returns:	hierarchical tree of descendants of the page object
Return type:	`dict`

_get_child_full_name(child_po)¶

Return full name of a child page object.

Returns:	full name of a child page object
Return type:	`str`

_get_child_name(child_po)¶

Return name of a child page object.

Returns:	name of a child page object
Return type:	`str`

_locator¶

Returns:	Locator of the page object
Return type:	Locator instance

_locator_class¶

Returns:	locator class
Return type:	Locator

_locator_value¶

Returns:	processed locator value ready to be passed to a webdriver find method
Return type:	str

_log_id_long¶

Returns:	String identifying the page object by its full name and locator.
Return type:	str

_log_id_short¶

Returns:	String identifying the page object by its full name.
Return type:	str

_parent_locator¶

Return the locator of the parent page object.

Returns:	Locator of parent or None if parent does not exist
Return type:	Locator or None

_parent_locator_value¶

Returns:	value of the parent locator
Return type:	str

_provided_locator¶

Returns:	locator string provided either to the constructor or as an overridden default_locator property
Return type:	str

_provided_url¶

Returns:	url string provided either as an overridden requested_url attribute or passed to the constructor
Return type:	str

children¶

Return dict of page object children.

Returns:	children of the page object
Return type:	`dict`

default_locator¶

Return default locator, None by default.

May be overridden to take precedence over the locator provided to constructor.

Returns:	default locator
Return type:	None (default) or str (if overridden)

full_name¶

Return full name of the page object instance.

If parent exists, ask for its child full name, otherwiser use normal short name.

Returns:	Full name of the pge object.
Return type:	str

See also

_get_child_full_name()

get_attribute(attribute, log=True)¶

Return an attribute value of the page object.

Parameters:	attribute (str) – attribute name log (bool) – whether to log or not (default is True)
Returns:	attribute value
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

init_children()¶

Initialize children of the page object.

Intended to be overridden by page objects containing other page objects.

Return type:	`None`

is_existing(log=True)¶

Return True if page object exists in the DOM, False otherwise.

Parameters:	log (bool) – whether to log or not (default is True)
Returns:	whether page object exists in the DOM
Return type:	bool

load(log=True)¶

Load the web page.

Parameters:	log (bool) – whether to log or not (defualt is True)
Returns:	self
Return type:	PageObjectBase instance

locator¶

Publicly exposed locator value.

Returns:	locator value
Return type:	str

logger¶

Return the logger object.

Returns:	standard logging module
Return type:	`logging`

name¶

Return name of the page object instance.

If parent exists, ask for its child name, otherwise use the name provided to constructor. If that doesn’t exist either, use DEFAULT_ROOT_NAME.

Returns:	Name of the page object.
Return type:	str

parent¶

Return the parent of the page object.

Returns:	Parent page object.
Return type:	`pageobject.pageobjectbase.PageObjectBase` or None (default)

requested_url¶

Return requested url, None by default.

May be overridden to take precedence over the url provided to constructor.

Returns:	requested url of the page
Return type:	str

text¶

Return text of the page object.

Returns:	text of the page object
Return type:	str
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

tree¶

Returns:	Hierarchical tree of page object and its descendants.
Return type:	dict

wait_for_exist(timeout=None)¶: DEPRECATED! Use wait_until_existing command instead.

wait_for_vanish(timeout=None)¶: DEPRECATED! Use wait_until_vanished command instead.

wait_until(func, func_args=[], func_kwargs={}, timeout=None, error_msg=None, reverse=False)¶

Wait until a condition is met.

Condition is an arbitrary function with optional args and kwargs that returns bool. If reverse=True, wait until the function returns False, otherwise wait until the function returns True (default).

Parameters:

func (function) – function returning bool that is repeatedly invoked until it returns correct value
func_args (list) – list of args to be passed to func
func_kwargs (dict) – dict of kwargs to be passed to func
timeout (int) – number of seconds to try to call func, if not provided, PageObject.DEFAULT_WAIT_TIMEOUT is used
error_msg (str) – error message to attach to the exception raised when the condition is not met in time
reverse (bool) – flag indicating whether to wait until the condition is True or False

Raises:

TimeoutException – if the condition is not met in time

wait_until_existing(timeout=None)¶

Wait until page object is existing in the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

wait_until_vanished(timeout=None)¶

Wait until page object vanishes from the DOM.

Parameters:	timeout (int) – number of seconds to wait, if not provided PageObject.DEFAULT_WAIT_TIMEOUT is used

webdriver¶

Return the instance of WebDriver.

If parent exists, use the webdriver property of the parent. Otherwise use the value provided to constructor.

Returns:	reference to the webdriver instance
Return type:	selenium.webdriver.Remote
Raises:	AssertionError – if the webdriver is not a valid WebDriver

webelement¶

Return a webelement instance.

Returns:	webelement instance
Return type:	`selenium.webdriver.remote.webelement.WebElement`
Raises:	NoSuchElementException – if the element cannot be found InvalidSelectorException – if the selector is invalid or doesn’t select an element

See also

selenium WebElement documentation (external link)

pageobject package¶

Subpackages¶

Submodules¶

pageobject.page module¶

pageobject.pageobject module¶

pageobject.pageobjectbase module¶

pageobject.pageobjectlist module¶

pageobject.select module¶

pageobject.singlepageobjectbase module¶

Module contents¶