locationBar

The locationBar class offers simpler access to the location bar and its elements.

Method overview

Attributes

Methods

locationBar()

Constructor of the locationBar class.

locationBar(
  in MozMillController controller
);

Parameters

controller

MozMillController of the browser window to operate on.

clear()

Focus and clear the location bar content.

clear();

Parameters

None.

contains()

Checks if the location bar contains the specified text.

contains(
  in string text
);

Parameters

text

Expected text, which should be contained inside the location bar.

Return value

true if the text is in the location bar, otherwise false.

focus()

Focus the location bar.

focus(
  in object event
);

Parameters

event

Event which should be used to focus the location bar (click or keyboard shortcut).

event.type (string)	Description
"click"	Use a mouse click.
"shortcut"	Use the keyboard shortcut

getElement()

Retrieves a UI element based on the given spec object.

ElemBase getElement(
  in object spec
);

Parameters

spec

JSON object which specifies the element to retrieve. Use its attributes to specify the exact element. This example shows the correct usage.

spec.type  (string)	spec.subtype (string)	spec.value (mixed)	Description
"favicon"	-	-	Get the favicon element.
"feedButton"	-	-	Get the RSS button element.
"goButton"	-	-	Get the Go Button element.
"historyDropMarker"	-	-	Get the drop down element for the auto-complete popup.
"identityBox"	-	-	Get the identity box element.
"starButton"	-	-	Get the Star Button element.
"urlBar"	-	-	Get the location bar element.

Return value

ElemBase instance of the requested element which matches the specifications.

loadURL()

Loads the specified URL by typing into the location bar.

loadURL(
  in string URL
);

Parameters

URL

URL to be loaded.

toggleAutocompletePopup()

Toggles between the open and closed state of the auto-complete pop-up.

toggleAutocompletePopup();

Parameters

None.

type()

Types the specified text into the location bar.

type(
  in string text
);

Parameters

text

Text to type into the location bar.