summaryrefslogtreecommitdiffstats
path: root/testing/web-platform/tests/navigation-api/ordering-and-transition/README.md
blob: 628b22ec48b7d0e93504eba7c734a74a916279ae (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
# Navigation API ordering/transition tests

These are meant to test the ordering between various events and promises, as
well as in some cases how the `navigation.transition` values changes.

Some of them use the `Recorder` framework in `resources/helpers.mjs`, and others
test tricky cases (e.g. reentrancy) in a more ad-hoc way.

<https://github.com/WICG/navigation-api/#complete-event-sequence> is a useful
reference for the intent of these tests.

Note:

* Variants specifically exist for `currententrychange` because an event listener
  existing for `currententrychange` causes code to run, and thus microtasks to run,
  at a very specific point in the navigation-commit lifecycle. We want to test
  that it doesn't impact the ordering.
* Similarly we test that `intercept()` does not change
  the ordering compared to no `intercept()` call, for same-document
  navigations, by trying to ensure most variants have appropriate
  `intercept()` counterparts with similar orderings.

TODOs:

* Also test `popstate` and `hashchange` once
  <https://github.com/whatwg/html/issues/1792> is fixed.