The add-on repository is a source of add-ons that can be installed. It can
 be searched in two ways. One returns a list of add-ons that come highly
 recommended, this list should change frequently. The other way is to
 search for specific search terms entered by the user. Searches are
 asynchronous and results should be passed to the provided callback object
 when complete. The results passed to the callback should only include add-ons
 that are compatible with the current application and are not already
 installed. Searches are always asynchronous and should be passed to the
 callback object provided.
[scriptable, uuid(c4d2ac29-6edc-43cd-8dc8-e4cf213aa1be)]
interface nsIAddonRepository : nsISupports

Attributes

 The homepage for visiting this repository. This may be null or an empty
 string.
readonly attribute AString homepageURL 
 Returns whether this instance is currently performing a search. New
 searches will not be performed while this is the case.
readonly attribute boolean isSearching

Methods

 Cancels the search in progress. If there is no search in progress this
 does nothing.
void cancelSearch() 
 The url that can be visited to see recommended add-ons in this repository.
AString getRecommendedURL() 
 Retrieves the url that can be visited to see search results for the given
 terms.

 @param  aSearchTerms  search terms used to search the repository
AString getSearchURL(in AString aSearchTerms) 
 Begins a search for recommended add-ons in this repository. Results will
 be passed to the given callback.

 @param  aMaxResults  the maximum number of results to return
 @param  aCallback    the callback to pass results to
void retrieveRecommendedAddons(in unsigned long aMaxResults, in nsIAddonSearchResultsCallback aCallback) 
 Begins a search for add-ons in this repository. Results will be passed to
 the given callback.

 @param  aSearchTerms  the terms to search for
 @param  aMaxResults   the maximum number of results to return
 @param  aCallback     the callback to pass results to
void searchAddons(in AString aSearchTerms, in unsigned long aMaxResults, in nsIAddonSearchResultsCallback aCallback)