Instant loading: internal anchor links don't work in Safari

[thesuperzapper]

Context

No response

Bug description

In MkDocs Material 9.4.8, it seems that internal heading anchor links don't work properly on Safari when using navigation.instant.

Note, this reliably happens, but sometimes you might need to clear your cache first.

Related links

• Instant loading does not work with section anchors in Safari #3797

Reproduction

9.4.8-safari-anchor-links.zip

Steps to reproduce

1. Use my reproduction.
2. Open the website in safari.
3. Click the link on the homepage.
4. Notice that you are at the top of the page, not scrolled to "Section 2"

(Also, I am not sure if it's related, but the table of contents sidebar will be partially cut off until you scroll the page)

Browser

Safari

Before submitting

• I have read and followed the bug reporting guidelines.
• I have attached links to the documentation, and possibly related issues and discussions.
• I assure that I have removed all customizations before submitting this bug report.
• I have attached a .zip file with a minimal reproduction.

[squidfunk]

Thanks for reporting. Could I ask you to try to bisect the version that introduced the problem? As you noted, we fixed it in #3797, so you would do us a great favor in helping isolate the bad commit ☺️

[thesuperzapper]

Well, I was also seeing this on 9.2.3, so I am not sure if that helps.

[thesuperzapper]

Another interesting issue which might be related (occurs on all browsers):

1. Click a internal link
2. Click the browser's back button
3. Click the same link again (fails to do anything)

[PaulSonOfLars]

Can confirm that when using navigation.instant and navigation.footer, the footer links will stop working after pressing the browser's "back" button

[squidfunk]

Thanks. Safari has been pesky to work with in the past. We'll investigate and fix this issue once we find some time to do a refactor of instant loading. In the meantime, you can disable navigation.instant to mitigate the problem.

[thesuperzapper]

@PaulSonOfLars @squidfunk I have raised a separate issue for the more serious problem I raised in #6334 (comment).

New issue: #6345

[squidfunk]

Fixed in https://github.com/squidfunk/mkdocs-material-insiders/pull/79 – the fixes are currently only in Insiders, so anybody having access can already test them. I still need to do some minor refactoring that shouldn't impact the functionality, and after that, I'll backport the fixes to the community edition. I just wanted to give them into the hands of users as soon as possible. This should resolve all known problems with instant loading, at least I've tested this and all other issues.

[squidfunk]

Fixes are now in #6662. Please check if the errors are now fixed when using this version in your project:

pip install git+https://github.com/squidfunk/mkdocs-material.git@fix/instant-loading-bugs