Revision control
Copy as Markdown
Other Tools
/* This Source Code Form is subject to the terms of the Mozilla Public
* License, v. 2.0. If a copy of the MPL was not distributed with this
/**
* Forces a url to open in an external application according to the protocol
* service settings.
*
* @param {string|nsIURI} url - A url string or an nsIURI containing the url to
* open.
*/
export function openLinkExternally(url) {
let uri = url;
if (!(uri instanceof Ci.nsIURI)) {
uri = Services.io.newURI(url);
}
// This can fail if there is a problem with the places database.
PlacesUtils.history
.insert({
url, // accepts both string and nsIURI
visits: [
{
date: new Date(),
},
],
})
.catch(console.error);
Cc["@mozilla.org/uriloader/external-protocol-service;1"]
.getService(Ci.nsIExternalProtocolService)
.loadURI(uri);
}
/**
*
* @param {string} query - The string to search for.
* @param {?nsISearchEngine} engine - The search engine to use.
*/
export function openWebSearch(query, engine) {
return Services.search.init().then(async () => {
if (!engine) {
engine = await Services.search.getDefault();
openLinkExternally(engine.getSubmission(query).uri.spec);
Services.telemetry.keyedScalarAdd(
"tb.websearch.usage",
engine.name.toLowerCase(),
1
);
}
});
}
export function openUILink(url, event) {
if (!event.button) {
PlacesUtils.history
.insert({
url,
visits: [
{
date: new Date(),
},
],
})
.catch(console.error);
Cc["@mozilla.org/uriloader/external-protocol-service;1"]
.getService(Ci.nsIExternalProtocolService)
.loadURI(Services.io.newURI(url));
}
}