For information on how to use experimental APIs, see the chrome.experimental.* APIs page.
The history API uses a transition type to describe
how the browser navigated to a particular URL
on a particular visit.
For example, if a user visits a page
by clicking a link on another page,
the transition type is LINK.
To be precise,
the type is
chrome.experimental.history.transitionType.LINK,
which has an integer value of 0.
Note:
The spelling of
transitionType changed in
revision 38850.
Previously, it was transistionType.
The following table describes each transition type defined by
chrome.experimental.history.transistionType.
| Transition type | Value | Description |
|---|---|---|
| LINK | 0 | The user got to this page by clicking a link on another page. |
| TYPED | 1 | The user got this page by typing the URL in the address bar. Also used for other explicit navigation actions. See also GENERATED, which is used for cases where the user selected a choice that didn't look at all like a URL. |
| AUTO_BOOKMARK | 2 | The user got to this page through a suggestion in the UI — for example, through a menu item. |
| AUTO_SUBFRAME | 3 | Subframe navigation. This is any content that is automatically loaded in a non-top-level frame. For example, if a page consists of several frames containing ads, those ad URLs have this transition type. The user may not even realize the content in these pages is a separate frame, and so may not care about the URL (see also MANUAL_SUBFRAME). |
| MANUAL_SUBFRAME | 4 | For subframe navigations that are explicitly requested by the user and generate new navigation entries in the back/forward list. An explicitly requested frame is probably more important than an automatically loaded frame because the user probably cares about the fact that the requested frame was loaded. |
| GENERATED | 5 | The user got to this page by typing in the address bar and selecting an entry that did not look like a URL. For example, a match might have the URL of a Google search result page, but it might appear to the user as "Search Google for ...". These are not quite the same as TYPED navigations because the user didn't type or see the destination URL. See also KEYWORD. |
| START_PAGE | 6 | The page was specified in the command line or is the start page. |
| FORM_SUBMIT | 7 | The user filled out values in a form and submitted it. Note that in some situations — such as when a form uses script to submit contents — submitting a form does not result in this transition type. |
| RELOAD | 8 | The user reloaded the page, either by clicking the reload button or by pressing Enter in the address bar. Session restore and Reopen closed tab use this transition type, too. |
| KEYWORD | 9 | The URL was generated from a replaceable keyword other than the default search provider. See also KEYWORD_GENERATED. |
| KEYWORD_GENERATED | 10 | Corresponds to a visit generated for a keyword. See also KEYWORD. |
For an example of using this API, see the history API test directory.