1.0 KiB
1.0 KiB
HTML vers PNG : rendu headless Puppeteer / Chromium
Date : 2026-06-21, révisé 09/07/2026 (retrait de l'approche Gotenberg — container désinstallé)
Contexte : html2canvas échoue dans les iframes sandbox (Claude.ai, widgets). Polices Google Fonts et SVG complexes bloqués par CORS. Solution : rendu serveur avec Chromium headless via Puppeteer (bash_tool Claude).
Pièges critiques
- Entry point : lib/puppeteer/puppeteer.js (pas lib/esm/)
- page.waitForTimeout() supprimé en v25+ → setTimeout natif
- --no-sandbox obligatoire dans container Claude
- networkidle0 + attente 2 s = polices externes chargées
Cas validé (2026-06-21)
Carte félicitations Bac 2026 — HTML/SVG 680×680 px + Google Fonts → PNG 1360×1360 px (137 Ko), upload Facebook direct.
Règle absolue : html2canvas = NON en iframe sandbox. Puppeteer = OUI. Note : l'ancienne « Approche 2 » via Gotenberg (HTML→PDF→PNG) n'existe plus — gotenberg a été désinstallé le 21/06/2026 (cf. cleanup-stack-documentaire.md).