Skip to content

PerformanceNavigationTiming.notRestoredReasons: untangle/expand reasons for null#44669

Open
SamB wants to merge 2 commits into
mdn:mainfrom
SamB:patch-2
Open

PerformanceNavigationTiming.notRestoredReasons: untangle/expand reasons for null#44669
SamB wants to merge 2 commits into
mdn:mainfrom
SamB:patch-2

Conversation

@SamB

@SamB SamB commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Description

Explain less-obvious reasons for this property to be null one at a time.

Motivation

The existing text seemed a bit confused, since back/forward navigations after restart are real enough. Given this, I assumed the explanation already present was actually written for the first circumstance only.

…ns for null

This seemed a bit confused, since back/forward navigations after restart are real enough.
@SamB SamB requested a review from a team as a code owner July 8, 2026 16:20
@SamB SamB requested review from chrisdavidmills and removed request for a team July 8, 2026 16:20
@github-actions github-actions Bot added Content:WebAPI Web API docs size/xs [PR only] 0-5 LoC changed labels Jul 8, 2026
@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Preview URLs (1 page)

(comment last updated: 2026-07-08 16:36:38)

Comment thread files/en-us/web/api/performancenavigationtiming/notrestoredreasons/index.md Outdated
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
@github-actions github-actions Bot added size/s [PR only] 6-50 LoC changed and removed size/xs [PR only] 0-5 LoC changed labels Jul 8, 2026

@chrisdavidmills chrisdavidmills left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi, @SamB, and thanks for the update! I really like your change, but I've provided the suggestion below to (I think) enhance it further.

Let me know what you think.


> [!NOTE]
> `notRestoredReasons` may return `null` despite the navigation type being reported as a back/forward navigation. These circumstances include duplicating a back/forward navigation in a new tab and restoring a back/forward navigation tab after a browser restart. In such cases, some browsers copy the navigation type from the original tab, but as these are not actually back/forward navigations, `notRestoredReasons` returns `null`.
> `notRestoredReasons` may return `null` despite the navigation type being reported as a back/forward navigation. These circumstances include:

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
> `notRestoredReasons` may return `null` despite the navigation type being reported as a back/forward navigation. These circumstances include:
It is worth noting that `notRestoredReasons` may return `null` even when the navigation type is reported as back/forward. These circumstances include:

And then put this content into normal text, not as a note (remove the "> [!NOTE]" line and the ">" characters from the line starts). My reasoning:

  • I think this info is getting a bit long to work as a note. At this point, it is more than 50% of the "Value" section.
  • I also think it is important, so it should be part of the central flow. Notes are often viewed as asides, and sometimes glossed over by readers.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Content:WebAPI Web API docs size/s [PR only] 6-50 LoC changed

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants