Implemented by
- @mozilla.org/embeddor.implemented/bookmark-charset-resolver;1
- @mozilla.org/browser/nav-history-service;1
- @mozilla.org/browser/download-history;1
- @mozilla.org/browser/global-history;2
- @mozilla.org/autocomplete/search;1?name=history
[scriptable, uuid(b333c6dd-3dbe-4c0b-8062-92ed92b7e7c9)]
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 Removes all history information about pages from a given host. If aEntireDomain is set, we will also delete pages from sub hosts (so if we are passed in "microsoft.com" we delete "www.microsoft.com", "msdn.microsoft.com", etc.). An empty host name means local files and anything else with no host name. You can also pass in the localized "(local files)" title given to you from a history query to remove all history information from local files. Note that this does not call observers for single deleted uris, but will send Begin/EndUpdateBatch.
void
removePagesFromHost(in AUTF8String aHost, in boolean aEntireDomain)
removeVisitsByTimeframe Removes all visits in a given timeframe. Limits are included: aBeginTime <= timeframe <= aEndTime. Any place that becomes unvisited as a result will also be deleted. Note that removal is performed in batch, so observers will not be notified of individual places that are deleted. Instead they will be notified onBeginUpdateBatch and onEndUpdateBatch.
void
removeVisitsByTimeframe(in long long aBeginTime, in long long aEndTime)
Compare to: