"Extensibly Awesome: A Jetpack API for the Firefox Location Bar"

I tweaked some of Mardak's code for the Twitter Add-on, and created a Jetpack module that makes it terribly simple to write add-ons that extend the awesomebar with your own suggestions. As an example, here's an add-on that uses the Google Translate API to translate text into a specified language directly in the location bar. If you type in the keyword 'translate', followed by a language code and some text, it will show the translation in the awesomebar results:

Screenshot

The code:

require('awesomebar').add({
  keyword: 'translate',
  onSearch: function(query, suggest) {
    let lang = query.substring(0, query.indexOf(' '));
    let text = query.substring(query.indexOf(' '));
    if (lang.length == 2 && text.length > 2) {
      translate(lang, text, function(translatedText) {
        suggest({
          title: 'Translated text in ' + lang + ': ' + translatedText,
          url: 'http://translate.google.com/?tl=' + lang +
               '&q=' + encodeURIComponent(text),
        }, true);
      });
    }
  }
});

function translate(lang, text, callback) { require('request').Request({ url: 'http://ajax.googleapis.com/ajax/services/language/translate', content: { v: '1.0', q: text, langpair: ''' + lang }, headers: { Referer: require('tabs').activeTab.location }, onComplete: function() { callback(this.response.json.responseData.translatedText); } }).get(); }

The example needs niceties such as being able to write full language names, but you get the gist.

Here's the awesomebar.js module.

There's a bit of documentation in there. The code could use some cleanup, and could probably be much smaller if converted to use the internal Jetpack APIs for things like window-watching, etc.