Class Browser

Init a Browser instance.

Parameters:

• qappargs - Arguments for QApplication constructor.
• debug_level - Debug level logging (ERROR by default)

Click any clickable element in page.

@param selector: jQuery selector.
@param wait_load: If True, it will wait until a new page is loaded.
@param timeout: Seconds to wait for the page to load before 
                               raising an exception.
@param wait_requests: How many requests to wait before returning. Useful
                      for AJAX requests.

By default this method will not wait for a page to load. 
If you are clicking a link or submit button, you must call this
method with C{wait_load=True} or, alternatively, call 
L{wait_load} afterwards. However, the recommended way it to use 
L{click_link}.
                
When a non-HTML file is clicked this method will download it. The 
file is automatically saved keeping the original structure (as 
wget --recursive does). For example, a file with URL 
I{http://server.org/dir1/dir2/file.ext} will be saved to  
L{download_directory}/I{server.org/dir1/dir2/file.ext}.                 

Wait until the page is loaded.

Parameters:

• timeout - Time to wait (seconds) for the page load to complete.

Returns:

Boolean state

Raises:

• SpynnerTimeout - If timeout is reached.

Wait some time.

Parameters:

• waittime - Time to wait (seconds).

  This is an active wait, the events loop will be run, so it may be useful to wait for synchronous Javascript events that change the DOM.

Inject Javascript code into the current context of page.

Parameters:

• jscode - Javascript code to injected.
• debug - Set to False to disable debug output for this injection.

  You can call Jquery even if the original page does not include it as Spynner injects the library for every loaded page. You must use _jQuery(...) instead of of jQuery or the common {$(...)} shortcut.

Set function callback for Javascript confirm pop-ups.

By default Javascript confirmations are not answered. If the webpage you are working pops Javascript confirmations, be sure to set a callback for them.

Calback signature: javascript_confirm_callback(url, message)

• url: Url where the popup was launched.
• param message: String message.

The callback should return a boolean (True meaning 'yes', False meaning 'no')

Set function callback for Javascript prompt.

By default Javascript prompts are not answered. If the webpage you are working pops Javascript prompts, be sure to set a callback for them.

Callback signature: javascript_prompt_callback(url, message, defaultvalue)

• url: Url where the popup prompt was launched.
• message: String message.
• defaultvalue: Default value for prompt answer

The callback should return a string with the answer or None to cancel the prompt.

Download a given URL using current cookies.

Parameters:

• url - URL or path to download
• outfd - Output file-like stream. If None, return data string.

Returns:

Bytes downloaded (None if something went wrong)

Set HTML parser used to generate the HTML soup.

Parameters:

• parser - Callback called to generate the soup.

  When a HTML parser is set for a Browser, the property soup returns the parsed HTML.

Set HTTP authentication request callback.

The callback must have this signature:

http_authentication_callback(url, realm):

• url: URL where the requested was made.
• realm: Realm requiring authentication.

The callback should return a pair of string containing (user, password) or None if you don't want to answer.

Take an image snapshot of the current frame.

Parameters:

• box - 4-element tuple containing box to capture (x1, y1, x2, y2). If None, capture the whole page.
• format - QImage format (see QImage::Format_*).

Returns:

A QImage image.

Typical usage:

>>> browser.load(url)
>>> browser.snapshot().save("webpage.png")

Set function callback to filter URL.

By default all requested elements of a page are loaded. That includes stylesheets, images and many other elements that you may not need at all. Use this method to define the callback that will be called every time a new request is made. The callback must have this signature:

my_url_filter(operation, url):

• operation: string with HTTP operation: get, head, post or put.
• url: requested item URL.

It should return True (proceed) or False (reject).

url

Current URL.

Get Method:

_get_url(self)

html

Rendered HTML in current page.

Get Method:

_get_html(self)

soup

HTML soup (see set_html_parser).

Get Method:

_get_soup(self)