the Chromium logo

The Chromium Projects

webNavigation v2

Proposal Date


Who is the primary contact for this API? jochen@

Who will be responsible for this API? (Team please, not an individual)

jochen@, mpcomplete@

Overview Now that the webNavigation API is released for a while, I learned about certain short-comings I'd like to fix. This proposal captures the required additions / changes to the current webNavigation API.

Use cases

Do you know anyone else, internal or external, that is also interested in this API? There were bug reports filed about this:

Could this API be part of the web platform? No, it's just an extension of an existing API

Do you expect this API to be fairly stable? How might it be extended or changed in the future? When we add new fancy navigation features (e.g. similar to prerendering), the API might need to be extended again.

If multiple extensions used this API at the same time, could they conflict with each others? If so, how do you propose to mitigate this problem? No* List every UI surface belonging to or potentially affected by your API: None Actions taken with extension APIs should be obviously attributable to an extension. Will users be able to tell when this new API is being used? How?

The API is only observing events, there should be no observable impact.

How could this API be abused? The API can be used to monitor each and every navigation, but that's already possible with v1. Imagine you’re Dr. Evil Extension Writer, list the three worst evil deeds you could commit with your API (if you’ve got good ones, feel free to add more): 1) observe each and every navigation, send it to some 3rd-party server 2) ... 3) profit What security UI or other mitigations do you propose to limit evilness made possible by this new API?** The webNavigation API already triggers a warning at install time. Alright Doctor, one last challenge:** Could a consumer of your API cause any permanent change to the user’s system using your API that would not be reversed when that consumer is removed from the system?** No How would you implement your desired features if this API didn't exist? You could guess that a page is being prerendered, or try to work around duplicate frame IDs. Draft API spec All existing events and methods that take or return a frame ID will in addition take a process ID. A frame is then uniquely identified by the tripple (tab id, process id, frame id).

The onCommitted signal's documentation is updated to state that the frame ID and process ID might have changed since the onBeforeNavigate signal.

Furthermore, this new event is introduced. :


chrome.webNavigation.onReplacedTab.addListener(function (object details) { ... });

Fired when a navigation is aborted, and instead a prerendered tab is swapped in.

Listener parameters

details (object)

sourceTabId (integer)

The ID of the tab being replaced

tabId (integer)

The ID of the tab replacing the sourceTabId

timeStamp (number)

The time when the browser was about to replace the tab in milliseconds since the epoch.

Open questions The proposed changes are "breaking changes" as an extension using v1 of the API will still experience the above referenced bugs. Is that ok?