Interface implemented by objects capable of fixing up strings into URIs
Converts an internal URI (e.g. a wyciwyg URI) into one which we can
expose to the user, for example on the URL bar.
| aURI | The URI to be converted |
| nsIURI The converted, exposable URI @throws NS_ERROR_MALFORMED_URI when the exposable portion of aURI is malformed @throws NS_ERROR_UNKNOWN_PROTOCOL when we can't get a protocol handler service for the URI scheme. |
Converts the specified string into a URI, first attempting
to correct any errors in the syntax or other vagaries. Returns
a wellformed URI or nullptr if it can’t.
| aURIText | Candidate URI. |
| aFixupFlags | Flags that govern ways the URI may be fixed up. |
| aPostData | The POST data to submit with the returned URI (see nsISearchSubmission). |
Same as createFixupURI, but returns information about what it corrected
(e.g. whether we could rescue the URI or “just” generated a keyword
search URI instead).
| aURIText | Candidate URI. |
| aFixupFlags | Flags that govern ways the URI may be fixed up. |
| aPostData | The POST data to submit with the returned URI (see nsISearchSubmission). |
Converts the specified keyword string into a URI. Note that it’s the
caller’s responsibility to check whether keywords are enabled and
whether aKeyword is a sensible keyword.
@throws NS_ERROR_FAILURE if the resulting URI requires submission of POST
data and aPostData is null.
| aKeyword | The keyword string to convert into a URI |
| aPostData | The POST data to submit to the returned URI (see nsISearchSubmission). |
No fixup flags. */
Allow the fixup to use a keyword lookup service to complete the URI.
The fixup object implementer should honour this flag and only perform
any lengthy keyword (or search) operation if it is set.
Tell the fixup to make an alternate URI from the input URI, for example
to turn foo into www.foo.com.
For an input that may be just a domain with only 1 level (eg, “mozilla”),
require that the host be whitelisted.
Overridden by FIXUP_FLAG_ALLOW_KEYWORD_LOOKUP.