Send an webNavigation event for navigations triggered by window.history

chrome/common/extensions/api/web_navigation.json

Index: chrome/common/extensions/api/web_navigation.json
diff --git a/chrome/common/extensions/api/web_navigation.json b/chrome/common/extensions/api/web_navigation.json
index 4ba546987da689a99add87d8c2affe2cdce0d800..a30e7171e452e130db6540c9be77ad340b189bfe 100644
--- a/chrome/common/extensions/api/web_navigation.json
+++ b/chrome/common/extensions/api/web_navigation.json
@@ -267,6 +267,30 @@
             }
           }
         ]
+      },
+      {
+        "name": "onHistoryStateUpdated",
+        "type": "function",
+        "description": "Fired when the frame's history was updated to a new URL. All future events for that frame will use the updated URL.",

[Matt Perry, 2012/07/16 20:42:50]

I don't understand this description. At first I thought this event was fired
when the user navigated back/forward, or when the page used history.goBack() or
history.goForward(). This description makes it sound like the event fires when
the page changes a previous history entry somehow. Which is the correct
interpretation?

[jochen (gone - plz use gerrit), 2012/07/16 20:53:36]

It's fired when a page changes it's history. Somehow is using
history.replaceState or history.pushState (see the test).

[Matt Perry, 2012/07/16 21:15:23]

OK, I'm probably confused because I don't really understand those methods.

+        "options": {
+          "supportsFilters": true,
+          "supportsListeners": true,
+          "supportsRules": false
+        },
+        "parameters": [
+          {
+            "type": "object",
+            "name": "details",
+            "properties": {
+              "tabId": {"type": "integer", "description": "The ID of the tab in which the navigation occurs."},
+              "url": {"type": "string"},
+              "frameId": {"type": "integer", "description": "0 indicates the navigation happens in the tab content window; a positive value indicates navigation in a subframe. Frame IDs are unique within a tab."},
+              "transitionType": {"type": "string", "enum": ["link", "typed", "auto_bookmark", "auto_subframe", "manual_subframe", "generated", "start_page", "form_submit", "reload", "keyword", "keyword_generated"], "description": "Cause of the navigation. The same transition types as defined in the history API are used."},
+              "transitionQualifiers": {"type": "array", "description": "A list of transition qualifiers.", "items": {"type": "string", "enum": ["client_redirect", "server_redirect", "forward_back", "from_address_bar"]}},
+              "timeStamp": {"type": "number", "description": "The time when the navigation was committed, in milliseconds since the epoch."}
+            }
+          }
+        ]
       }
     ]
   }