Gets a nsISearchSubmission object that contains information about what to
send to the search engine, including the URI and postData, if applicable.
| data | Data to add to the submission object. i.e. the search terms. |
| responseType | [optional] The MIME type that we'd like to receive in response to this submission. If null, will default to "text/html". |
| purpose | [optional] A string meant to indicate the context of the search request. This allows the search service to provide a different nsISearchSubmission depending on e.g. where the search is triggered in the UI. |
| A nsISearchSubmission object that contains information about what to send to the search engine. If no submission can be obtained for the given responseType, returns null. |
Adds a parameter to the search engine’s submission data. This should only
be called on engines created via addEngineWithDetails.
@throws NS_ERROR_FAILURE if the search engine is read-only.
@throws NS_ERROR_INVALID_ARG if name or value are null.
| name | The parameter's name. Must not be null. |
| value | The value to pass. If value is "{searchTerms}", it will be substituted with the user-entered data when retrieving the submission. Must not be null. |
| responseType | Since an engine can have several different request URLs, differentiated by response types, this parameter selects a request to add parameters to. If null, will default to "text/html" |
Determines whether the engine can return responses in the given
MIME type. Returns true if the engine spec has a URL with the
given responseType, false otherwise.
| responseType | The MIME type to check for |
Returns a string with the URL to an engine’s icon matching both width and
height. Returns null if icon with specified dimensions is not found.
| width | Width of the requested icon. |
| height | Height of the requested icon. |
Gets an array of all available icons. Each entry is an object with
width, height and url properties. width and height are numeric and
represent the icon’s dimensions. url is a string with the URL for
the icon.
Opens a speculative connection to the engine’s search URI
(and suggest URI, if different) to reduce request latency
@throws NS_ERROR_INVALID_ARG if options is omitted or lacks required
elemeents
| options | An object that must contain the following fields: {window} the content window for the window performing the search |
Gets a string representing the hostname from which search results for a
given responseType are returned, minus the leading “www.” (if present).
This can be specified as an url attribute in the engine description file,
but will default to host from the
| responseType | [optional] The MIME type to get resultDomain for. Defaults to "text/html". |
| the resultDomain for the given responseType. |
An optional shortcut alias for the engine.
When non-null, this is a unique identifier.
A text description describing the engine.
Whether the engine should be hidden from the user.
A nsIURI corresponding to the engine’s icon, stored locally. May be null.
The display name of the search engine. This is a unique identifier.
A URL string pointing to the engine’s search form.
The search engine type.
An optional unique identifier for this search engine within the context of
the distribution, as provided by the distributing entity.
Supported search engine types.
Supported search engine data types.