Rewrite history API guide; delete old example (#30354)

* Rewrite history API guide; delete old example * Typo * Add JSON sample * Apply suggestions from code review Co-authored-by: Jean-Yves Perrier <[email protected]> * Update files/en-us/web/api/history_api/working_with_the_history_api/index.md Co-authored-by: Jean-Yves Perrier <[email protected]> --------- Co-authored-by: Jean-Yves Perrier <[email protected]>
mdn · Nov 20, 2023 · 56bbf28 · 56bbf28
1 parent d23f8c5
commit 56bbf28
Show file tree

Hide file tree

Showing 6 changed files with 141 additions and 507 deletions.
diff --git a/files/en-us/_redirects.txt b/files/en-us/_redirects.txt
@@ -1385,7 +1385,7 @@
 /en-US/docs/DOM/LinkStyle	/en-US/docs/Web/API/HTMLLinkElement
 /en-US/docs/DOM/Locating_DOM_elements_using_selectors	/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors
 /en-US/docs/DOM/Manipulating_the_browser_history	/en-US/docs/Web/API/History_API
-/en-US/docs/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Example
+/en-US/docs/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Working_with_the_History_API
 /en-US/docs/DOM/MediaQueryList	/en-US/docs/Web/API/MediaQueryList
 /en-US/docs/DOM/MediaQueryListListener	/en-US/docs/Web/API/MediaQueryList
 /en-US/docs/DOM/MediaStream	/en-US/docs/Web/API/MediaStream
@@ -8619,6 +8619,7 @@
 /en-US/docs/Web/API/HashChangeEvent/HashChangeEvent.oldURL	/en-US/docs/Web/API/HashChangeEvent/oldURL
 /en-US/docs/Web/API/Headers/getAll	/en-US/docs/Web/API/Headers/get
 /en-US/docs/Web/API/History.length	/en-US/docs/Web/API/History/length
+/en-US/docs/Web/API/History_API/Example	/en-US/docs/Web/API/History_API/Working_with_the_History_API
 /en-US/docs/Web/API/IDBCursor.advance	/en-US/docs/Web/API/IDBCursor/advance
 /en-US/docs/Web/API/IDBCursor.continue	/en-US/docs/Web/API/IDBCursor/continue
 /en-US/docs/Web/API/IDBCursor.delete	/en-US/docs/Web/API/IDBCursor/delete
@@ -11996,7 +11997,7 @@
 /en-US/docs/Web/Guide/API/DOM/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/Web/Guide/API/DOM/Locating_DOM_elements_using_selectors	/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors
 /en-US/docs/Web/Guide/API/DOM/Manipulating_the_browser_history	/en-US/docs/Web/API/History_API
-/en-US/docs/Web/Guide/API/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Example
+/en-US/docs/Web/Guide/API/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Working_with_the_History_API
 /en-US/docs/Web/Guide/API/DOM/Storage	/en-US/docs/Web/API/Web_Storage_API
 /en-US/docs/Web/Guide/API/DOM/The_structured_clone_algorithm	/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
 /en-US/docs/Web/Guide/API/DOM/Using_dynamic_styling_information	/en-US/docs/Web/API/CSS_Object_Model/Using_dynamic_styling_information
@@ -12065,7 +12066,7 @@
 /en-US/docs/Web/Guide/DOM/Events/Using_device_orientation_with_3D_transforms	/en-US/docs/Web/API/Device_orientation_events/Using_device_orientation_with_3D_transforms
 /en-US/docs/Web/Guide/DOM/Locating_DOM_elements_using_selectors	/en-US/docs/Web/API/Document_object_model/Locating_DOM_elements_using_selectors
 /en-US/docs/Web/Guide/DOM/Manipulating_the_browser_history	/en-US/docs/Web/API/History_API
-/en-US/docs/Web/Guide/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Example
+/en-US/docs/Web/Guide/DOM/Manipulating_the_browser_history/Example	/en-US/docs/Web/API/History_API/Working_with_the_History_API
 /en-US/docs/Web/Guide/DOM/Storage	/en-US/docs/Web/API/Web_Storage_API
 /en-US/docs/Web/Guide/DOM/The_structured_clone_algorithm	/en-US/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
 /en-US/docs/Web/Guide/DOM/Using_dynamic_styling_information	/en-US/docs/Web/API/CSS_Object_Model/Using_dynamic_styling_information

diff --git a/files/en-us/_wikihistory.json b/files/en-us/_wikihistory.json
@@ -42314,23 +42314,6 @@
       "peterson.victor222"
     ]
   },
-  "Web/API/History_API/Example": {
-    "modified": "2019-09-05T07:52:37.814Z",
-    "contributors": [
-      "irenesmith",
-      "RichWK",
-      "sunnywalker",
-      "teoli",
-      "fusionchess",
-      "wbamberg",
-      "alispivak",
-      "sickOfNamesPasswordsetc",
-      "wctaiwan",
-      "Sheppy",
-      "giabao",
-      "jamel"
-    ]
-  },
   "Web/API/History_API/Working_with_the_History_API": {
     "modified": "2019-12-27T13:55:25.264Z",
     "contributors": [

diff --git a/files/en-us/web/api/history/replacestate/index.md b/files/en-us/web/api/history/replacestate/index.md
@@ -14,8 +14,6 @@ URL passed in the method parameters. This method is particularly useful
 when you want to update the state object or URL of the current history entry in response
 to some user action.
 
-This method is {{glossary("asynchronous")}}. Add a listener for the {{domxref("Window/popstate_event", "popstate")}} event in order to determine when the navigation has completed. The `state` parameter will be available in it.
-
 ## Syntax
 
 ```js-nolint