SPB Git

Repository Public

srcdoc.ts 10.8 KB 216 lines typescript

1// Document d'aperçu d'un modèle, destiné à l'attribut srcdoc d'un <iframe sandbox> SANS allow-scripts ni allow-same-origin.2// Même défense en profondeur que la lecture des messages (mail/sanitize.ts), chaque couche suffisant seule :3//   1. DOMPurify sur le document entier (ni script, ni cadre, ni formulaire, ni gestionnaire d'événement, ni <base>/<meta>/<link>) ;4//   2. seconde passe : liens http(s)/mailto seulement, CSS neutralisé (ni @import, ni @font-face, ni url() distante),5//      images distantes remplacées par une URL data: — la page les récupère par le mandataire /api/img et les passe ici ;6//   3. CSP interne « default-src 'none'; img-src data: » : même si quelque chose échappait aux deux premières couches,7//      le document ne peut ni exécuter de code ni joindre le réseau.8// Le HTML d'un modèle n'est jamais inséré dans le document de l'application.9import DOMPurify from "dompurify"10import { READER_CSP, neutralizeCss } from "../mail/sanitize"11import { forceColorScheme, hasDarkStyles, type ColorScheme } from "./darkmode"1213type PurifyWindow = Parameters<typeof DOMPurify>[0]14type Purifier = ReturnType<typeof DOMPurify>1516export interface PreviewOptions {17  /** rendu forcé ; absent = clair */18  scheme?: ColorScheme19  /** images déjà récupérées : URL d'origine (https) → URL data: */20  images?: ReadonlyMap<string, string>21  /** miniature : pas de barre de défilement, aucun lien actif */22  thumbnail?: boolean23  lang?: string24  /** fenêtre DOM à utiliser (jsdom dans les tests) */25  window?: PurifyWindow26}2728export interface PreviewDocument {29  /** document complet pour srcdoc */30  srcdoc: string31  /** URL https des images référencées (balises <img>, fonds, url() CSS), sans doublon, dans l'ordre du document */32  remoteImages: string[]33  /** le modèle prévoit un rendu sombre (@media (prefers-color-scheme: dark)) */34  hasDark: boolean35}3637const FORBID_TAGS = [38  "script", "noscript", "template", "iframe", "frame", "frameset", "noframes", "object", "embed", "applet", "portal", "slot",39  "base", "meta", "link", "svg", "math", "form", "input", "button", "select", "textarea", "option", "optgroup", "datalist", "keygen", "output",40  "video", "audio", "source", "track", "canvas", "dialog", "marquee", "bgsound", "layer", "ilayer", "xml", "plaintext", "listing", "xmp", "picture",41]42const FORBID_ATTR = [43  "srcset", "sizes", "action", "formaction", "ping", "poster", "data", "dynsrc", "lowsrc", "longdesc", "usemap", "ismap", "manifest", "profile",44  "contenteditable", "autofocus", "tabindex", "accesskey", "draggable", "download", "is", "nonce", "integrity", "crossorigin", "referrerpolicy", "loading", "decoding", "fetchpriority",45  "name", "popover", "popovertarget", "inert", "slot", "part", "exportparts", "srcdoc", "xlink:href",46]4748const purifiers = new WeakMap<object, Purifier>()49function purifierFor(win?: PurifyWindow): Purifier {50  if (!win) return DOMPurify51  let p = purifiers.get(win as object)52  if (!p) {53    p = DOMPurify(win)54    purifiers.set(win as object, p)55  }56  return p57}5859const SAFE_DATA_IMAGE = /^data:image\/(?:png|jpeg|gif|webp|avif|bmp|x-icon|vnd\.microsoft\.icon);base64,[a-z0-9+/=]*$/i60const HTTPS_URL = /^https:\/\/[^\s"'<>\\()]+$/i61const SAFE_LINK = /^(?:https?:\/\/|mailto:)[^\s"'<>]*$/i62/** Image transparente 1 × 1 : tient la place d'une image distante pas encore (ou jamais) récupérée. */63export const BLANK_IMAGE = "data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7"64const CSS_URL = /url\(\s*(?:"(https:\/\/[^"\\\s()<>]+)"|'(https:\/\/[^'\\\s()<>]+)'|(https:\/\/[^"'\\\s()<>]+))\s*\)/gi6566export const PREVIEW_CSP = READER_CSP6768/** URL du mandataire d'images pour une image distante (seul chemin par lequel une image de modèle est chargée). */69export function proxyUrl(remote: string): string {70  return `/api/img?u=${encodeURIComponent(remote)}`71}7273function escapeAttr(s: string): string {74  return s.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;")75}7677class Collector {78  readonly urls: string[] = []79  private seen = new Set<string>()80  constructor(private images: ReadonlyMap<string, string> | undefined) {}81  /** Enregistre l'URL distante et rend ce qui peut la remplacer dans le cadre (URL data: récupérée, ou `null`). */82  resolve(url: string): string | null {83    if (!this.seen.has(url)) {84      this.seen.add(url)85      this.urls.push(url)86    }87    const data = this.images?.get(url)88    return data && SAFE_DATA_IMAGE.test(data) ? data : null89  }90}9192/** CSS d'un modèle : images distantes remplacées (ou retirées), rendu clair/sombre forcé, tout le reste neutralisé. */93function processCss(css: string, scheme: ColorScheme, collect: Collector, inline = false): string {94  // 1. les url(https://…) deviennent des url("data:…") quand l'image a été récupérée ; sinon elles seront retirées à l'étape 295  const withImages = css.replace(CSS_URL, (m, a?: string, b?: string, c?: string) => {96    const url = a ?? b ?? c ?? ""97    if (!HTTPS_URL.test(url)) return m98    const data = collect.resolve(url)99    return data ? `url("${data}")` : "none"100  })101  // 2. plus rien ne peut charger une ressource ni exécuter de code (url() restantes, @import, @font-face, expression()…)102  const safe = neutralizeCss(withImages).css103  return inline ? safe : forceColorScheme(safe, scheme)104}105106const baseCss = (scheme: ColorScheme, thumbnail: boolean) =>107  `:root{color-scheme:${scheme} only}html{-webkit-text-size-adjust:100%}img{max-width:100%}` +108  (thumbnail ? "html,body{overflow:hidden!important}*{animation:none!important;transition:none!important}a{pointer-events:none}" : "")109110/**111 * Construit le document d'aperçu. Sans DOM (rendu côté serveur, test mal configuré), rend un document vide plutôt que112 * de laisser passer du HTML non assaini.113 */114export function buildPreviewDocument(html: string, opts: PreviewOptions = {}): PreviewDocument {115  const scheme: ColorScheme = opts.scheme === "dark" ? "dark" : "light"116  const collect = new Collector(opts.images)117  const purifier = purifierFor(opts.window)118  const head = `<meta charset="utf-8"><meta http-equiv="Content-Security-Policy" content="${PREVIEW_CSP}"><meta name="referrer" content="no-referrer"><meta name="viewport" content="width=device-width,initial-scale=1"><meta name="color-scheme" content="${scheme}"><title>${escapeAttr(opts.lang === "en" ? "preview" : "aperçu")}</title>`119  const empty: PreviewDocument = { srcdoc: `<!doctype html><html lang="${escapeAttr(opts.lang ?? "fr")}"><head>${head}</head><body></body></html>`, remoteImages: [], hasDark: false }120  if (!purifier.isSupported) return empty121122  const root = purifier.sanitize(html, {123    WHOLE_DOCUMENT: true,124    RETURN_DOM: true,125    FORBID_TAGS,126    FORBID_ATTR,127    ADD_TAGS: ["style", "center"],128    ADD_ATTR: ["target", "bgcolor", "background", "valign", "cellpadding", "cellspacing", "border", "align", "role", "width", "height"],129    ALLOW_DATA_ATTR: false,130    ALLOW_ARIA_ATTR: true,131    ALLOW_UNKNOWN_PROTOCOLS: false,132    SANITIZE_DOM: true,133    FORCE_BODY: false,134  }) as unknown as HTMLElement135  const doc = root.ownerDocument136  const htmlEl = root.tagName === "HTML" ? root : root.querySelector("html")137  if (!doc || !htmlEl) return empty138  const body = htmlEl.querySelector("body")139  if (!body) return empty140141  // ---- feuilles de style (où qu'elles soient : Gmail accepte <style> dans <head>, certains outils en posent dans <body>)142  let hasDark = false143  const sheets: string[] = []144  for (const el of Array.from(htmlEl.querySelectorAll("style"))) {145    const raw = el.textContent ?? ""146    if (hasDarkStyles(raw)) hasDark = true147    const css = processCss(raw, scheme, collect).replace(/</g, "")148    if (css.trim()) sheets.push(css)149    el.remove()150  }151152  // ---- éléments153  for (const el of Array.from(htmlEl.querySelectorAll("*"))) {154    for (const a of Array.from(el.attributes)) {155      const name = a.name.toLowerCase()156      // ceinture et bretelles : DOMPurify les retire déjà157      if (name.startsWith("on") || name === "srcdoc" || name === "srcset" || name === "formaction") el.removeAttribute(a.name)158    }159    const style = el.getAttribute("style")160    if (style !== null) {161      const css = processCss(style, scheme, collect, true).replace(/[<{}]/g, "")162      if (css.trim()) el.setAttribute("style", css)163      else el.removeAttribute("style")164    }165    // fond d'un tableau ou d'une cellule (attribut HTML hérité, encore utilisé pour Outlook)166    const bg = el.getAttribute("background")167    if (bg !== null) {168      el.removeAttribute("background")169      const url = bg.trim()170      const data = HTTPS_URL.test(url) ? collect.resolve(url) : null171      if (data) el.setAttribute("style", `${el.getAttribute("style") ?? ""};background-image:url("${data}")`.replace(/^;/, ""))172    }173    if (el.tagName === "IMG") {174      const src = (el.getAttribute("src") ?? "").trim()175      if (HTTPS_URL.test(src)) el.setAttribute("src", collect.resolve(src) ?? BLANK_IMAGE)176      else if (!SAFE_DATA_IMAGE.test(src)) el.setAttribute("src", BLANK_IMAGE) // http:, cid:, variable non remplie, chemin relatif…177    } else if (el.hasAttribute("src")) el.removeAttribute("src")178    if (el.tagName === "A" || el.tagName === "AREA") {179      const href = (el.getAttribute("href") ?? "").trim()180      if (href && SAFE_LINK.test(href) && !opts.thumbnail) {181        el.setAttribute("href", href)182        el.setAttribute("target", "_blank")183        el.setAttribute("rel", "noopener noreferrer nofollow")184      } else if (el.hasAttribute("href")) {185        // lien non http(s)/mailto, variable brute, ancre : le lien garde son apparence mais ne mène nulle part186        el.removeAttribute("href")187        el.removeAttribute("target")188        if (href) el.setAttribute("data-inert-link", "")189      }190    } else if (el.hasAttribute("href")) el.removeAttribute("href")191  }192193  let headEl = htmlEl.querySelector("head")194  if (!headEl) {195    headEl = doc.createElement("head")196    htmlEl.insertBefore(headEl, htmlEl.firstChild)197  }198  // tout ce qui restait dans <head> (titre d'origine…) est remplacé par notre en-tête : CSP en premier199  const styleTags = [baseCss(scheme, !!opts.thumbnail), ...sheets].map((css) => `<style>${css}</style>`).join("")200  const lang = escapeAttr(opts.lang ?? htmlEl.getAttribute("lang") ?? "fr")201  const bodyAttrs = Array.from(body.attributes)202    .map((a) => ` ${a.name}="${escapeAttr(a.value)}"`)203    .join("")204  const linkCss = "<style>a[data-inert-link]{cursor:default}</style>"205  return {206    srcdoc: `<!doctype html><html lang="${lang}"><head>${head}${styleTags}${linkCss}</head><body${bodyAttrs}>${body.innerHTML}</body></html>`,207    remoteImages: collect.urls,208    hasDark,209  }210}211212/** Seulement la liste des images distantes d'un modèle (pour les récupérer avant de construire l'aperçu définitif). */213export function collectRemoteImages(html: string, window?: PurifyWindow): string[] {214  return buildPreviewDocument(html, { window }).remoteImages215}216
Files main
Menu

Theme