z3c.etestbrowser 1.5.0

Extended testbrowser

This package provides some extensions to Zope 3’s testbrowser. It is intended for extensions that have dependencies that we do not want to rely on in the Zope 3 core e.g. lxml.

Extended testbrowser using zope.app.wsgi.testlayer

There is also a variant in z3c.etestbrowser.wsgi which can be used when the test layer was set up using zope.app.wsgi.testlayer instead of zope.app.testing:

Example:

>>> import z3c.etestbrowser.wsgi
>>> browser = z3c.etestbrowser.wsgi.ExtendedTestBrowser()
>>> browser.open("http://localhost/")
>>> print browser.contents
<!DOCTYPE ...>
...
</html>
>>> browser.etree
<Element html at ...>
>>> browser.etree.xpath('//body')
[<Element body at ...>]

Using testbrowser on the internet

The z3c.etestbrowser.browser module exposes an ExtendedTestBrowser class that simulates a web browser similar to Mozilla Firefox or IE.

>>> from z3c.etestbrowser.browser import ExtendedTestBrowser
>>> browser = ExtendedTestBrowser()

It can send arbitrary headers; this is helpful for setting the language value, so that your tests format values the way you expect in your tests, if you rely on zope.i18n locale-based formatting or a similar approach.

>>> browser.addHeader('Accept-Language', 'en-US')

The browser can open web pages:

>>> # This is tricky, since in Germany I am forwarded to google.de usually;
>>> # The `ncr` forces to really go to google.com.
>>> browser.open('http://google.com/ncr')
>>> browser.url
'http://www.google.com/'
>>> 'html' in browser.contents.lower()
True

We can access the etree of the page .. contents:

>>> browser.etree.xpath('//body')
[<Element body at ...>]

We’ll put some text in the query box…

>>> browser.getControl(name='q').value = 'z3c.etestbrowser'

…and then click the search button.

>>> browser.getControl('Google Search').click()
Traceback (most recent call last):
...
RobotExclusionError: HTTP Error 403: request disallowed by robots.txt

Oops! Google doesn’t let robots use their search engine. Oh well.