class splinter.element_list.ElementList(elements: list, driver=None, find_by=None, query=None)[source]

Bases: object

Collection of elements.

Each member of the collection is by default an instance of ElementAPI.

Beyond the traditional list methods, ElementList provides some other methods, listed below.

There is a peculiar behavior on ElementList: you never get an IndexError. Instead, you get an ElementDoesNotExist exception when trying to access a non-existent item:

>>> element_list = ElementList([])
>>> element_list[0] # raises ElementDoesNotExist
property first

An alias to the first element of the list.


>>> assert element_list[0] == element_list.first
is_empty() bool[source]

Check if the ElementList is empty.


True if the list is empty, else False

Return type:


property last

An alias to the last element of the list.


>>> assert element_list[-1] == element_list.last