WebDriver/Marionette/Marionette Client API: Difference between revisions

From MozillaWiki
Jump to navigation Jump to search
(Created page with "When writing Marionette tests in Python, the following API's are available. These are all available in the self.marionette object which is available to all Marionette tests. Mo...")
 
No edit summary
Line 11: Line 11:
* {{ok|get_window()}}: returns an id representing the current window
* {{ok|get_window()}}: returns an id representing the current window
* {{ok|get_windows()}}: returns a list of all available windows
* {{ok|get_windows()}}: returns a list of all available windows
* {{ok|switch_to_window(window)}}: sets the window to which future commands will be targeted; 'window' is one of the id's returned by get_windows()
* {{ok|switch_to_window(window)}}: sets the active window; all future commands will be targeted here. 'window' is one of the id's returned by get_windows().
* {{ok|switch_to_frame(id)}}: sets the active frame; all future commands will be targeted here.  'id' is either the id of an iframe, an HTMLElement (see below) representing an iframe, or None to target the default top-level frame.

Revision as of 06:37, 8 December 2011

When writing Marionette tests in Python, the following API's are available. These are all available in the self.marionette object which is available to all Marionette tests. Most of these API's are analogs to Selenium methods documented here:

Configuration

  • [DONE] set_script_timeout(ms): sets the timeout for asynchronous scripts
  • [DONE] set_search_timeout(ms): sets the maximum time Marionette will wait while searching for a DOM element using any of the find_ methods

Context Management

  • [DONE] set_context(context): sets the context in which future commands will be executed; 'context' is either "chrome" or "content"
  • [ON TRACK] get_window(): returns an id representing the current window
  • [ON TRACK] get_windows(): returns a list of all available windows
  • [ON TRACK] switch_to_window(window): sets the active window; all future commands will be targeted here. 'window' is one of the id's returned by get_windows().
  • [ON TRACK] switch_to_frame(id): sets the active frame; all future commands will be targeted here. 'id' is either the id of an iframe, an HTMLElement (see below) representing an iframe, or None to target the default top-level frame.