Skip to content

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

Merged
chrisdavidmills merged 4 commits into
mdn:mainfrom
SamB:patch-2
Sep 1, 2026
Merged

PerformanceNavigationTiming.notRestoredReasons: untangle/expand reasons for null#44669
chrisdavidmills merged 4 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
Comment thread files/en-us/web/api/performancenavigationtiming/notrestoredreasons/index.md Outdated
@github-actions

github-actions Bot commented Jul 8, 2026

Copy link
Copy Markdown
Contributor

Preview URLs (1 page)

(comment last updated: 2026-09-01 09:27:12)

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.

@Josh-Cena
Josh-Cena requested a review from a team as a code owner September 1, 2026 08:58
@Josh-Cena
Josh-Cena requested review from chrisdavidmills and wbamberg and removed request for a team September 1, 2026 08:58

@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.

Cool, this is ready to merge. Thanks again, @SamB.

@chrisdavidmills
chrisdavidmills merged commit bebf5d9 into mdn:main Sep 1, 2026
8 of 9 checks passed
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.

4 participants