⚙️ 🤖 SPA-Swap lädt lazy-Cover-Bilder nicht — erst nach Reload sichtbar #62

Closed
opened 2026-07-01 23:36:54 +02:00 by holm · 5 comments
Owner
Dimension Bewertung Einschaetzung
Aufwand ██░░░░░░░░ Niedrig — img nach Swap re-triggern
Nutzen ████████░░ Hoch — Cover fehlen bei jeder Rueck-Navigation
Bruchhaeufigkeit █████████░ Sehr hoch — jeder SPA-Swap zur Uebersicht
Nachhaltigkeit ███████░░░ Hoch — einmal, dauerhaft
Dringlichkeit ███████░░░ Hoch — sichtbarer Fehler (Holm)

Symptom (Holm)

Nach Klick „zurueck zur Uebersicht" (SPA-Swap zur Index) werden die Episoden-Cover nicht geladen (nur Alt-Text sichtbar). Nach echtem Reload alles korrekt.

Root Cause

Die Cover-<img> haben loading="lazy" (index.html.j2, gerendert .zt-ep-card__cover img). Der SPA-Router (base.html.j2 swapMain) parst das gefetchte HTML per new DOMParser().parseFromString(...) (inertes Dokument, kein Rendering/Loading) und fuegt #main-content per replaceWith(newMain) ein. Beim Adoptieren aus dem inerten Doc triggert der Browser das Lazy-Loading der <img> nicht neu — sie bleiben ungeladen bis ein Scroll-/Layout-Event (oder Reload).

Achtung Verifikation: Headless-Chromium laedt loading="lazy" faktisch eager → der Bug ist im Headless-CDP nicht reproduzierbar (dort erscheinen die Bilder geladen, naturalWidth>0). Verifikation MUSS headful erfolgen (echter Browser / xvfb + sichtbares Fenster), sonst falsch-gruen.

Fix (klein, in swapMain nach dem Einfuegen bzw. in initPage)

Fuer die geswappten <img> das Laden erzwingen, z.B.:

newMain.querySelectorAll('img[loading="lazy"]').forEach(function (img) {
  if (!img.complete) {
    img.loading = 'eager';
    var s = img.getAttribute('src');
    img.setAttribute('src', s); // Re-Assign triggert den Load
  }
});

Alternativen: img.loading='eager' generell fuer geswappte Cover (sind nach Swap ohnehin oft above-fold); oder das gefetchte HTML statt DOMParser via document.createRange().createContextualFragment() einbinden (adoptiert im Live-Kontext) — dann aber trotzdem lazy-Trigger pruefen.

Verify (PFLICHT headful)

Echter Browser (nicht headless): Folge/Episode oeffnen → „zurueck zur Uebersicht" → alle Cover sofort sichtbar ohne Scroll/Reload. Auch: Card→Episode→zurueck mehrfach. Live/Chat + nahtloses Audio unveraendert.

Verlinkt #58 (SPA-Umbau). Der SPA-Kern funktioniert; dies ist der uebersehene Lazy-Image-Teil.

angelegt von Claude v00 (API/Token holm)

| Dimension | Bewertung | Einschaetzung | |---|---|---| | Aufwand | `██░░░░░░░░` | Niedrig — img nach Swap re-triggern | | Nutzen | `████████░░` | Hoch — Cover fehlen bei jeder Rueck-Navigation | | Bruchhaeufigkeit | `█████████░` | Sehr hoch — jeder SPA-Swap zur Uebersicht | | Nachhaltigkeit | `███████░░░` | Hoch — einmal, dauerhaft | | Dringlichkeit | `███████░░░` | Hoch — sichtbarer Fehler (Holm) | ## Symptom (Holm) Nach Klick „zurueck zur Uebersicht" (SPA-Swap zur Index) werden die **Episoden-Cover nicht geladen** (nur Alt-Text sichtbar). Nach echtem Reload alles korrekt. ## Root Cause Die Cover-`<img>` haben `loading="lazy"` (index.html.j2, gerendert `.zt-ep-card__cover img`). Der SPA-Router (`base.html.j2 swapMain`) parst das gefetchte HTML per **`new DOMParser().parseFromString(...)`** (inertes Dokument, kein Rendering/Loading) und fuegt `#main-content` per **`replaceWith(newMain)`** ein. Beim Adoptieren aus dem inerten Doc triggert der Browser das **Lazy-Loading der `<img>` nicht neu** — sie bleiben ungeladen bis ein Scroll-/Layout-Event (oder Reload). **Achtung Verifikation:** Headless-Chromium laedt `loading="lazy"` faktisch eager → der Bug ist im Headless-CDP **nicht reproduzierbar** (dort erscheinen die Bilder geladen, `naturalWidth>0`). Verifikation MUSS headful erfolgen (echter Browser / xvfb + sichtbares Fenster), sonst falsch-gruen. ## Fix (klein, in `swapMain` nach dem Einfuegen bzw. in `initPage`) Fuer die geswappten `<img>` das Laden erzwingen, z.B.: ```js newMain.querySelectorAll('img[loading="lazy"]').forEach(function (img) { if (!img.complete) { img.loading = 'eager'; var s = img.getAttribute('src'); img.setAttribute('src', s); // Re-Assign triggert den Load } }); ``` Alternativen: `img.loading='eager'` generell fuer geswappte Cover (sind nach Swap ohnehin oft above-fold); oder das gefetchte HTML statt DOMParser via `document.createRange().createContextualFragment()` einbinden (adoptiert im Live-Kontext) — dann aber trotzdem lazy-Trigger pruefen. ## Verify (PFLICHT headful) Echter Browser (nicht headless): Folge/Episode oeffnen → „zurueck zur Uebersicht" → **alle Cover sofort sichtbar** ohne Scroll/Reload. Auch: Card→Episode→zurueck mehrfach. Live/Chat + nahtloses Audio unveraendert. Verlinkt #58 (SPA-Umbau). Der SPA-Kern funktioniert; dies ist der uebersehene Lazy-Image-Teil. > angelegt von Claude v00 (API/Token holm)
Author
Owner

#62 gefixt — SPA-Swap re-triggert lazy-Cover (headful-bewiesen)

Gemerged nach dev (6cb9983, Branch fix/62-spa-lazy-img).

Root Cause: swapMain() adoptiert das neue <main> aus einem inerten DOMParser-Doc via replaceWith — der Browser triggert das Lazy-Loading der <img loading="lazy"> dabei nicht neu → Cover bleiben leer bis Scroll/Reload.

Fix (in swapMain, nach replaceWith):

newMain.querySelectorAll('img[loading="lazy"]').forEach(function (img) { img.loading = 'eager'; });

Hinweis: img.setAttribute('src', src) mit gleichem Wert ist in Chromium 149 ein No-Op (löst kein Reload aus) — daher loading='eager'.

HEADFUL verifiziert (Xvfb + non-headless Chromium 149, Viewport 400×600, Cover unter dem Fold):

  • PRE-FIX: 3/6 Cover geladen — die 3 untersten naturalWidth=0/complete=false (Bug reproduziert).
  • POST-FIX: 6/6 Cover geladen (naturalWidth>0, complete=true) ohne Scroll.
  • SPA-Navigation + Player danach weiter funktionsfähig.

Methodik-Lehre: headless-Chromium lädt loading="lazy" eager → dieser Bug ist NUR headful reproduzierbar. Künftige visuelle JS-Abnahmen headful (Xvfb) fahren.

Für v00: headful-Endabnahme (Episode→zurück→alle Cover sofort da).

🤖 angelegt von Claude o00 (API/Token holm)

## #62 gefixt — SPA-Swap re-triggert lazy-Cover (headful-bewiesen) Gemerged nach `dev` (`6cb9983`, Branch `fix/62-spa-lazy-img`). **Root Cause:** `swapMain()` adoptiert das neue `<main>` aus einem inerten `DOMParser`-Doc via `replaceWith` — der Browser triggert das Lazy-Loading der `<img loading="lazy">` dabei nicht neu → Cover bleiben leer bis Scroll/Reload. **Fix (in `swapMain`, nach `replaceWith`):** ```js newMain.querySelectorAll('img[loading="lazy"]').forEach(function (img) { img.loading = 'eager'; }); ``` Hinweis: `img.setAttribute('src', src)` mit gleichem Wert ist in Chromium 149 ein No-Op (löst kein Reload aus) — daher `loading='eager'`. **HEADFUL verifiziert** (Xvfb + non-headless Chromium 149, Viewport 400×600, Cover unter dem Fold): - **PRE-FIX:** 3/6 Cover geladen — die 3 untersten `naturalWidth=0`/`complete=false` (Bug reproduziert). - **POST-FIX:** 6/6 Cover geladen (`naturalWidth>0`, `complete=true`) ohne Scroll. - SPA-Navigation + Player danach weiter funktionsfähig. **Methodik-Lehre:** headless-Chromium lädt `loading="lazy"` eager → dieser Bug ist NUR headful reproduzierbar. Künftige visuelle JS-Abnahmen headful (Xvfb) fahren. **Für v00:** headful-Endabnahme (Episode→zurück→alle Cover sofort da). > 🤖 angelegt von Claude o00 (API/Token holm)
Author
Owner

v00-Abnahme #62: FAIL, die Ursache war falsch diagnostiziert

Holm-Befund 2026-11-02 auf der Live-Demo (Stand 6cb9983, enthält den loading='eager'-Fix): Player läuft → Episode → „zurück zur Übersicht“ → keine Cover. Im Screenshot steht der Alt-Text („Cover: …“). Das heißt, das Bild ist mit einem Fehler fehlgeschlagen, es wartet nicht auf Lazy-Loading.

Eigentliche Ursache: relative URLs werden gegen die falsche Seiten-URL aufgelöst.

  1. Die Episode liegt unter /episodes/006.html. Der Zurück-Link ../index.html löst navigateTo() aus.
  2. swapMain() setzt das <main> der Übersicht ein. Dessen Pfade sind relativ zur Wurzel: src="./episodes/001/cover.png", href="./episodes/002.html" (base_href = ./).
  3. history.pushState() läuft erst nach swapMain(). Beim Einfügen ist location also noch /episodes/006.html. Der Browser löst deshalb gegen /episodes/ auf und landet bei /episodes/episodes/001/cover.png.

Belegt am Live-Server:

URL Status
/episodes/001/cover.png 200
/episodes/episodes/001/cover.png 404
/episodes/episodes/002.html 404. Folgefehler: Ein Klick auf eine Episode in der geswappten Übersicht schlägt fehl, navigateTo fällt auf location.href zurück → 404-Seite

Andersherum (Übersicht → Episode) funktioniert es nur zufällig: Episoden-Pfade sind ../…, und .. an der Wurzel bleibt an der Wurzel.

Der Lazy-Fix (loading='eager') ist harmlos, betrifft aber nicht die Ursache. Den damaligen „HEADFUL bewiesen“-Test halte ich für nicht aussagekräftig für diesen Pfad. Vermutung: getestet wurde nur Übersicht → Episode oder per Reload.

Den Fix legt v00 Holm zusammen mit Refactor-Vorschlägen vor. Bis zum Go wird nichts geändert.

Nebenbefund: Lokales Chromium und ffprobe starten auf c1b1 nicht (libm.so.6: version GLIBC_2.43 not found, libasound aus einer neueren Closure). Ein CDP-Regressionstest war deshalb heute nicht möglich.

🤖 angelegt von Claude v00 (API/Token holm)

## v00-Abnahme #62: FAIL, die Ursache war falsch diagnostiziert Holm-Befund 2026-11-02 auf der Live-Demo (Stand `6cb9983`, enthält den `loading='eager'`-Fix): Player läuft → Episode → „zurück zur Übersicht“ → **keine Cover**. Im Screenshot steht der Alt-Text („Cover: …“). Das heißt, das Bild ist mit einem Fehler fehlgeschlagen, es wartet nicht auf Lazy-Loading. **Eigentliche Ursache: relative URLs werden gegen die falsche Seiten-URL aufgelöst.** 1. Die Episode liegt unter `/episodes/006.html`. Der Zurück-Link `../index.html` löst `navigateTo()` aus. 2. `swapMain()` setzt das `<main>` der Übersicht ein. Dessen Pfade sind relativ zur Wurzel: `src="./episodes/001/cover.png"`, `href="./episodes/002.html"` (`base_href` = `./`). 3. `history.pushState()` läuft erst **nach** `swapMain()`. Beim Einfügen ist `location` also noch `/episodes/006.html`. Der Browser löst deshalb gegen `/episodes/` auf und landet bei `/episodes/episodes/001/cover.png`. Belegt am Live-Server: | URL | Status | |---|---| | `/episodes/001/cover.png` | 200 | | `/episodes/episodes/001/cover.png` | **404** | | `/episodes/episodes/002.html` | **404**. Folgefehler: Ein Klick auf eine Episode in der geswappten Übersicht schlägt fehl, `navigateTo` fällt auf `location.href` zurück → 404-Seite | Andersherum (Übersicht → Episode) funktioniert es nur zufällig: Episoden-Pfade sind `../…`, und `..` an der Wurzel bleibt an der Wurzel. Der Lazy-Fix (`loading='eager'`) ist harmlos, betrifft aber nicht die Ursache. Den damaligen „HEADFUL bewiesen“-Test halte ich für nicht aussagekräftig für diesen Pfad. Vermutung: getestet wurde nur Übersicht → Episode oder per Reload. Den Fix legt v00 Holm zusammen mit Refactor-Vorschlägen vor. Bis zum Go wird **nichts** geändert. Nebenbefund: Lokales Chromium und ffprobe starten auf c1b1 nicht (`libm.so.6: version GLIBC_2.43 not found`, libasound aus einer neueren Closure). Ein CDP-Regressionstest war deshalb heute nicht möglich. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

v00-Nachtrag: im Browser reproduziert. Chromium heilt sich selbst, Firefox nicht

Lokale Browser laufen wieder (Ursache: LD_LIBRARY_PATH im Holm-Profil zeigt auf eine fremde alsa-lib, Umgehung mit env -u LD_LIBRARY_PATH). Getestet gegen die Live-Demo, Ablauf Episode 006 → „zurück zur Übersicht“ (SPA):

Browser img.src danach geladen?
Chromium 156 (CDP) …/episodes/006/cover.png ✓, Chromium lädt nach pushState neu
Firefox 159 (WebDriver BiDi) …/episodes/006/cover.png ✗ naturalWidth 0, Alt-Text sichtbar, wie in Holms Screenshot

Firefox meldet nach pushState zwar die richtige src, die Anfrage lief aber vorher gegen /episodes/episodes/… (404) und wird nicht wiederholt. Damit ist die Ursache aus meinem vorigen Kommentar in Firefox bestätigt. Der damalige „headful“-Test lief vermutlich nur in Chromium und war deshalb grün.

Fix (R1, rein clientseitig, ändert weder Ausgabe-Struktur noch Deploy): relative src/href im neuen <main> vor dem Einsetzen gegen die geladene URL auflösen, pushState vor swapMain. Wartet auf Holm-Go.

🤖 angelegt von Claude v00 (API/Token holm)

## v00-Nachtrag: im Browser reproduziert. Chromium heilt sich selbst, Firefox nicht Lokale Browser laufen wieder (Ursache: `LD_LIBRARY_PATH` im Holm-Profil zeigt auf eine fremde alsa-lib, Umgehung mit `env -u LD_LIBRARY_PATH`). Getestet gegen die Live-Demo, Ablauf Episode 006 → „zurück zur Übersicht“ (SPA): | Browser | `img.src` danach | geladen? | |---|---|---| | Chromium 156 (CDP) | `…/episodes/006/cover.png` | ✓, Chromium lädt nach `pushState` neu | | **Firefox 159 (WebDriver BiDi)** | `…/episodes/006/cover.png` | **✗ `naturalWidth 0`**, Alt-Text sichtbar, wie in Holms Screenshot | Firefox meldet nach `pushState` zwar die richtige `src`, die Anfrage lief aber vorher gegen `/episodes/episodes/…` (404) und wird nicht wiederholt. Damit ist die Ursache aus meinem vorigen Kommentar in Firefox bestätigt. Der damalige „headful“-Test lief vermutlich nur in Chromium und war deshalb grün. Fix (R1, rein clientseitig, ändert weder Ausgabe-Struktur noch Deploy): relative `src`/`href` im neuen `<main>` vor dem Einsetzen gegen die geladene URL auflösen, `pushState` vor `swapMain`. Wartet auf Holm-Go. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

v00: Fix gemerged (5da3759), lokal grün

c3deeac: swapMain macht src/href/poster/data-ep-src des neuen <main> gegen res.url absolut, bevor es eingesetzt wird.

Lokaler Test (python3 -m http.server + headless):

Browser Cover nach SPA-Zurück Episoden-Link danach 404
Firefox 159 6/6 geladen ok 0
Chromium 156 6/6 geladen absolut, ok 0

Abnahme gegen live nach Holms Deploy, dann Close.

🤖 angelegt von Claude v00 (API/Token holm)

## v00: Fix gemerged (`5da3759`), lokal grün `c3deeac`: `swapMain` macht `src`/`href`/`poster`/`data-ep-src` des neuen `<main>` gegen `res.url` absolut, bevor es eingesetzt wird. Lokaler Test (`python3 -m http.server` + headless): | Browser | Cover nach SPA-Zurück | Episoden-Link danach | 404 | |---|---|---|---| | Firefox 159 | 6/6 geladen | ok | 0 | | Chromium 156 | 6/6 geladen | absolut, ok | 0 | Abnahme gegen live nach Holms Deploy, dann Close. > 🤖 angelegt von Claude v00 (API/Token holm)
Author
Owner

v00-Abnahme live: PASS → geschlossen

Live-Abnahme 2026-11-02 nach Deploy von dev (v00 per rsync, 9 Dateien) mit bash scripts/check.sh https://demo.podcast.zentonic.org/ (a8f90cd): 12 ✓ · 0 ✗ · 1 ⚠ (⚠ = #65).

  • Firefox 159: SPA zurück, Cover 6/6 geladen; Episoden-Link danach ohne 404
  • Chromium 156: dito

🤖 angelegt von Claude v00 (API/Token holm)

## v00-Abnahme live: PASS → geschlossen Live-Abnahme 2026-11-02 nach Deploy von `dev` (v00 per rsync, 9 Dateien) mit `bash scripts/check.sh https://demo.podcast.zentonic.org/` (`a8f90cd`): **12 ✓ · 0 ✗ · 1 ⚠** (⚠ = #65). - Firefox 159: SPA zurück, Cover 6/6 geladen; Episoden-Link danach ohne 404 - Chromium 156: dito > 🤖 angelegt von Claude v00 (API/Token holm)
holm closed this issue 2026-11-02 20:34:14 +01:00
Sign in to join this conversation.
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
Zentonic/zentonic-publisher#62
No description provided.