Linux Mac OSX Windows

Implemented by


  
[scriptable, uuid(96602bf3-de2a-42ed-812f-a83b130e6299)]
interface nsIBrowserHistory : nsIGlobalHistory2

Attributes

 count

 Indicate if there are entries in global history
 For performance reasons this does not return the real number of entries
readonly attribute PRUint32 count
 lastPageVisited

 The last page that was visited in a top-level window.
readonly attribute AUTF8String lastPageVisited

Methods

 addPageWithDetails

 Adds a page to history with specific time stamp information. This is used in
 the History migrator. 
void addPageWithDetails(in nsIURI aURI, in wstring aTitle, in long long aLastVisited)
 hidePage

 Hide the specified URL from being enumerated (and thus
 displayed in the UI)
 If the page hasn't been visited yet, then it will be added
 as if it was visited, and then marked as hidden
void hidePage(in nsIURI aURI)
 markPageAsTyped

 Designate the url as having been explicitly typed in by
 the user, so it's okay to be an autocomplete result.
void markPageAsTyped(in nsIURI aURI)
 removeAllPages

 Remove all pages from global history
void removeAllPages()
 removePage

 Remove a page from history
void removePage(in nsIURI aURI)
 removePages

 Remove a bunch of pages from history
 Notice that this does not call observers for performance reasons,
 instead setting aDoBatchNotify true will send Begin/EndUpdateBatch
void removePages([array, size_is(aLength)] in nsIURI aURIs, in unsigned long aLength, in boolean aDoBatchNotify)
 removePagesByTimeframe

 Remove all pages for a given timeframe.
 Limits are included: aBeginTime <= timeframe <= aEndTime
 Notice that this does not call observers for single deleted uris,
 instead it will send Begin/EndUpdateBatch
void removePagesByTimeframe(in long long aBeginTime, in long long aEndTime)
 removePagesFromHost

 Remove all pages from the given host.
 If aEntireDomain is true, will assume aHost is a domain,
 and remove all pages from the entire domain.
 Notice that this does not call observers for single deleted uris,
 instead it will send Begin/EndUpdateBatch
void removePagesFromHost(in AUTF8String aHost, in boolean aEntireDomain)