Back to index
Provides information about global history to gecko, extending GlobalHistory2. More...
|void||addDocumentRedirect (in nsIChannel aOldChannel, in nsIChannel aNewChannel, in PRInt32 aFlags, in boolean aTopLevel)|
|Notifies the history system that the page loading via aOldChannel redirected to aNewChannel. |
|void||addURI (in nsIURI aURI, in boolean aRedirect, in boolean aToplevel, in nsIURI aReferrer)|
|Add a URI to global history. |
|boolean||isVisited (in nsIURI aURI)|
|Checks to see whether the given URI is in history. |
|void||setPageTitle (in nsIURI aURI, in AString aTitle)|
|Set the page title for the given uri. |
Provides information about global history to gecko, extending GlobalHistory2.
|void nsIGlobalHistory3::addDocumentRedirect||(||in nsIChannel||aOldChannel,|
Notifies the history system that the page loading via aOldChannel redirected to aNewChannel.
Implementations should generally add the URI for aOldChannel to history for link coloring, but are advised not to expose it in the history user interface. This function is preferred if nsIGlobalHistory3 is available. Otherwise, nsIGlobalHistory2.addURI should be called with redirect=true.
This function is preferred to nsIGlobalHistory2.addURI because it provides more information (including the redirect destination, channels involved, and redirect flags) to the history implementation.
For implementors of nsIGlobalHistory3: The history implementation is responsible for sending NS_LINK_VISITED_EVENT_TOPIC to observers for redirect pages. This notification must be sent for history consumers for all non-redirect pages.
|aToplevel||whether the URI is loaded in a top-level window. If false, the load is in a subframe.|
The other params to this function are the same as those for nsIChannelEventSink::OnChannelRedirect.
Note: Implementors who wish to implement this interface but rely on nsIGlobalHistory2.addURI for redirect processing may throw NS_ERROR_NOT_IMPLEMENTED from this method. If they do so, then callers must call nsIGlobalHistory2.addURI upon getting the NS_ERROR_NOT_IMPLEMENTED result.
|void nsIGlobalHistory2::addURI||(||in nsIURI||aURI,|
Add a URI to global history.
|aURI||the URI of the page|
|aRedirect||whether the URI was redirected to another location; this is 'true' for the original URI which is redirected.|
|aToplevel||whether the URI is loaded in a top-level window|
|aReferrer||the URI of the referring page|
Checks to see whether the given URI is in history.
|aURI||the uri to the page|
Set the page title for the given uri.
URIs that are not already in global history will not be added.
|aURI||the URI for which to set to the title|
|aTitle||the page title|