← KennisKnowledgeConnaissances

The page that kept saying “Connecting…”

After I put a new version of this site online, some visitors got stuck. The live game tables showed “Connecting…” and never got any further. A reload fixed it, but nobody knew they had to reload.

What was going on

The interactive parts of this site run in the browser (Blazor WebAssembly). The files they need have a fingerprint in their name, for example dotnet.ik73ot6xxj.js. A new version gets new names, so a browser can never mix an old file with a new one.

That is exactly what went wrong for a page that was already open before the update. It still asked for the old names. The server only had the new ones, answered “not found”, and the browser gave up with the error Failed to start platform. It gave up quietly: the page just stayed on “Connecting…”.

The fix

The page now listens for that one error. When it sees it, it reloads itself once, so it fetches the new page with the new names.

  • Only that error. A real fault in the program must stay visible, not be hidden behind a reload.
  • At most once a minute. The time of the last reload is kept in the browser tab (sessionStorage). If the site is really down, the page does not keep reloading itself forever.
  • Nothing to configure. It is a few lines of script in the page itself, so it also works for a page that was opened before the fix existed, as soon as it is loaded again once.

The lesson: fingerprinted file names are right, but they make every page that is open during an update a page from the past. Decide in advance what such a page should do.

De pagina die bleef zeggen “Verbinden…”

Nadat ik een nieuwe versie van deze site online zette, liepen sommige bezoekers vast. De live speltafels toonden “Verbinden…” en kwamen nooit verder. Herladen loste het op, maar niemand wist dat hij moest herladen.

Wat er gebeurde

De interactieve delen van deze site draaien in de browser (Blazor WebAssembly). De bestanden die ze nodig hebben dragen een vingerafdruk in hun naam, bijvoorbeeld dotnet.ik73ot6xxj.js. Een nieuwe versie krijgt nieuwe namen, zodat een browser nooit een oud bestand met een nieuw kan mengen.

Precies daar liep het mis voor een pagina die al open stond vóór de update. Die vroeg nog naar de oude namen. De server had alleen de nieuwe, antwoordde “niet gevonden”, en de browser gaf het op met de fout Failed to start platform. Hij gaf het stil op: de pagina bleef gewoon op “Verbinden…” staan.

De oplossing

De pagina luistert nu naar die ene fout. Ziet ze die, dan herlaadt ze zichzelf één keer en haalt zo de nieuwe pagina met de nieuwe namen op.

  • Alleen die fout. Een echte fout in het programma moet zichtbaar blijven, niet verstopt achter een herlaadbeurt.
  • Hoogstens één keer per minuut. Het tijdstip van de laatste herlaadbeurt wordt bewaard in het browsertabblad (sessionStorage). Ligt de site echt plat, dan blijft de pagina zichzelf niet eindeloos herladen.
  • Niets in te stellen. Het zijn een paar regels script in de pagina zelf, dus het werkt ook voor een pagina die geopend werd voor de oplossing bestond, zodra die één keer opnieuw geladen is.

De les: bestandsnamen met een vingerafdruk zijn juist, maar ze maken van elke pagina die openstaat tijdens een update een pagina uit het verleden. Beslis op voorhand wat zo'n pagina moet doen.

La page qui disait toujours « Connexion… »

Après la mise en ligne d'une nouvelle version de ce site, certains visiteurs restaient bloqués. Les tables de jeu en direct affichaient « Connexion… » et n'allaient jamais plus loin. Recharger la page réglait le problème, mais personne ne savait qu'il fallait recharger.

Ce qui se passait

Les parties interactives de ce site tournent dans le navigateur (Blazor WebAssembly). Les fichiers dont elles ont besoin portent une empreinte dans leur nom, par exemple dotnet.ik73ot6xxj.js. Une nouvelle version reçoit de nouveaux noms, pour qu'un navigateur ne mélange jamais un ancien fichier avec un nouveau.

C'est justement là que ça coinçait pour une page déjà ouverte avant la mise à jour. Elle demandait encore les anciens noms. Le serveur n'avait que les nouveaux, répondait « introuvable », et le navigateur abandonnait avec l'erreur Failed to start platform. Il abandonnait en silence : la page restait simplement sur « Connexion… ».

La solution

La page écoute maintenant cette erreur précise. Quand elle la voit, elle se recharge une fois et récupère ainsi la nouvelle page avec les nouveaux noms.

  • Seulement cette erreur. Une vraie erreur du programme doit rester visible, pas être cachée derrière un rechargement.
  • Au plus une fois par minute. L'heure du dernier rechargement est gardée dans l'onglet (sessionStorage). Si le site est vraiment en panne, la page ne se recharge pas sans fin.
  • Rien à régler. Ce sont quelques lignes de script dans la page elle-même, donc cela marche aussi pour une page ouverte avant que la solution existe, dès qu'elle a été rechargée une fois.

La leçon : les noms de fichiers avec empreinte sont la bonne approche, mais ils transforment chaque page ouverte pendant une mise à jour en page du passé. Décide à l'avance ce qu'une telle page doit faire.

An unhandled error has occurred. Reload 🗙