Update Wizard Dialog

UpdateWizardDialog

class firefox_puppeteer.ui.update_wizard.dialog.UpdateWizardDialog(marionette, window_handle)

Representation of the old Software Update Wizard Dialog.

close(callback=None, force=False)

Closes the current chrome window.

If this is the last remaining window, the Marionette session is ended.

Parameters:
  • callback – Optional, function to trigger the window to open. It is triggered with the current BaseWindow as parameter. Defaults to window.open().
  • force – Optional, forces the closing of the window by using the Gecko API. Defaults to False.
closed

Returns closed state of the chrome window.

Returns:True if the window has been closed.
focus()

Sets the focus to the current chrome window.

focused

Returns True if the chrome window is focused.

Returns:True if the window is focused.
handle

Returns the window handle of the chrome window.

Returns:window handle.
loaded

Checks if the window has been fully loaded.

Returns:True, if the window is loaded.
localize_entity(entity_id)

Returns the localized string for the specified DTD entity id.

Parameters:entity_id – The id to retrieve the value from.
Returns:The localized string for the requested entity.
Raises:MarionetteException – When entity id is not found.
localize_property(property_id)

Returns the localized string for the specified property id.

Parameters:property_id – The id to retrieve the value from.
Returns:The localized string for the requested property.
Raises:MarionetteException – When property id is not found.
menubar

Provides access to the menu bar, for example, the File menu.

See the MenuBar reference.

open_window(callback=None, expected_window_class=None, focus=True)

Opens a new top-level chrome window.

Parameters:
  • callback – Optional, function to trigger the window to open. It is triggered with the current BaseWindow as parameter. Defaults to window.open().
  • expected_class – Optional, check for the correct window class.
  • focus – Optional, if true, focus the new window. Defaults to True.
select_next_page()

Clicks on “Next” button, and waits for the next page to show up.

send_shortcut(command_key, **kwargs)

Sends a keyboard shortcut to the window.

Parameters:
  • command_key – The key (usually a letter) to be pressed.
  • accel – Optional, If True, the Accel modifier key is pressed. This key differs between OS X (Meta) and Linux/Windows (Ctrl). Defaults to False.
  • alt – Optional, If True, the Alt modifier key is pressed. Defaults to False.
  • ctrl – Optional, If True, the Ctrl modifier key is pressed. Defaults to False.
  • meta – Optional, If True, the Meta modifier key is pressed. Defaults to False.
  • shift – Optional, If True, the Shift modifier key is pressed. Defaults to False.
switch_to(focus=False)

Switches the context to this chrome window.

By default it will not focus the window. If that behavior is wanted, the focus parameter can be used.

Parameters:focus – If True, the chrome window will be focused.
Returns:Current window as BaseWindow instance.
window_element

Returns the inner DOM window element.

Returns:DOM window element.
wizard

The Wizard instance which represents the wizard.

Returns:Reference to the wizard.

Wizard

class firefox_puppeteer.ui.update_wizard.wizard.Wizard(*args, **kwargs)
checking

The checking for updates panel.

Returns:CheckingPanel instance.
downloading

The downloading panel.

Returns:DownloadingPanel instance.
dummy

The dummy panel.

Returns:DummyPanel instance.
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
error

The errors panel.

Returns:ErrorPanel instance.
error_extra

The error extra panel.

Returns:ErrorExtraPanel instance.
error_patching

The error patching panel.

Returns:ErrorPatchingPanel instance.
finished

The finished panel.

Returns:FinishedPanel instance.
finished_background

The finished background panel.

Returns:FinishedBackgroundPanel instance.
incompatible_check

The incompatible check panel.

Returns:IncompatibleCheckPanel instance.
incompatible_list

The incompatible list panel.

Returns:IncompatibleListPanel instance.
manual_update

The manual update panel.

Returns:ManualUpdatePanel instance.
no_updates_found

The no updates found panel.

Returns:NoUpdatesFoundPanel instance.
panels

List of all the available Panel instances.

Returns:List of Panel instances.
selected_index

The index of the currently selected panel.

Returns:Index of the selected panel.
selected_panel

A Panel instance of the currently selected panel.

Returns:Panel instance.
updates_found_basic

The updates found panel.

Returns:UpdatesFoundPanel instance.
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

CheckingPanel

class firefox_puppeteer.ui.update_wizard.wizard.CheckingPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
progress

The DOM element which represents the progress meter.

Returns:Reference to the progress element.
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

DownloadingPanel

class firefox_puppeteer.ui.update_wizard.wizard.DownloadingPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
progress

The DOM element which represents the progress meter.

Returns:Reference to the progress element.
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

DummyPanel

class firefox_puppeteer.ui.update_wizard.wizard.DummyPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

ErrorPatchingPanel

class firefox_puppeteer.ui.update_wizard.wizard.ErrorPatchingPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

ErrorPanel

class firefox_puppeteer.ui.update_wizard.wizard.ErrorPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

ErrorExtraPanel

class firefox_puppeteer.ui.update_wizard.wizard.ErrorExtraPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

FinishedPanel

class firefox_puppeteer.ui.update_wizard.wizard.FinishedPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

FinishedBackgroundPanel

class firefox_puppeteer.ui.update_wizard.wizard.FinishedBackgroundPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

IncompatibleCheckPanel

class firefox_puppeteer.ui.update_wizard.wizard.IncompatibleCheckPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
progress

The DOM element which represents the progress meter.

Returns:Reference to the progress element.
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

IncompatibleListPanel

class firefox_puppeteer.ui.update_wizard.wizard.IncompatibleListPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

InstalledPanel

LicensePanel

ManualUpdatePanel

class firefox_puppeteer.ui.update_wizard.wizard.ManualUpdatePanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

NoUpdatesFoundPanel

class firefox_puppeteer.ui.update_wizard.wizard.NoUpdatesFoundPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.

PluginUpdatesFoundPanel

UpdatesFoundBasicPanel

class firefox_puppeteer.ui.update_wizard.wizard.UpdatesFoundBasicPanel(marionette, window, element)
element

Returns the reference to the underlying DOM element.

Returns:Reference to the DOM element
window

Returns the reference to the chrome window.

Returns:BaseWindow instance of the chrome window.