Les Trusted Types
Pourquoi c'est important La CSP bloque les balises de script injectées. Mais beaucoup de bogues modernes vivent dans ton propre JavaScript : une ligne comme box.innerHTML = comment transforme le texte d'un visiteur en HTML vivant. C'est l'injection basée sur le DOM du module 10 (leçon 59), et elle se produit après le chargement de la page. Les Trusted Types font refuser au navigateur ces lignes dangereuses sauf si la valeur est passée par une vérification que tu as écrite.
Imagine une usine où seules les pièces portant un tampon d'inspection peuvent aller sur la chaîne de montage. Personne ne peut y boulonner une pièce trouvée au hasard sur le parking, même par accident. Les Trusted Types ajoutent ce tampon aux chaînes que ton code envoie dans les endroits dangereux.
DOM : abréviation de Document Object Model, l'arbre vivant d'éléments que le navigateur construit à partir d'une page, que JavaScript peut lire et modifier.
Puits (sink) : un endroit du DOM où une chaîne devient du code ou du balisage. Exemples : element.innerHTML, outerHTML, insertAdjacentHTML, document.write, iframe.srcdoc, eval et les arguments chaînes de setTimeout, et script.src.
Trusted Types : une fonction du navigateur, activée par la CSP, sous laquelle ces puits n'acceptent que des objets spéciaux (TrustedHTML, TrustedScript, TrustedScriptURL) fabriqués par une politique, une petite fonction que tu écris et nommes. Une simple chaîne affectée à un puits lève une erreur au lieu de s'exécuter.
L'activer
Content-Security-Policy: require-trusted-types-for 'script'; trusted-types commentsrequire-trusted-types-for 'script': l'appliquer à tous les puits liés aux scripts.trusted-types comments: le seul nom de politique que ton code peut créer. Un script injecté ne peut pas enregistrer sa propre politique sous un autre nom.trusted-types 'none'interdit d'en créer aucune.
L'utiliser dans ton code
// The one, reviewed place that turns text into HTML.
const commentsPolicy = trustedTypes.createPolicy("comments", {
createHTML: (text) => escapeHtml(text), // or a well-tested sanitiser
});
box.innerHTML = comment; // throws TypeError: blocked
box.innerHTML = commentsPolicy.createHTML(comment); // allowed, escaped
box.textContent = comment; // not a sink at all: always fineLe grand gain est pour les relecteurs. Au lieu de traquer chaque innerHTML dans une grosse base de code, tu relis les quelques fonctions de politique. Si elles sont sûres, le navigateur impose que tout le reste passe par elles.
Une politique nommée default est spéciale : le navigateur l'appelle automatiquement chaque fois qu'une simple chaîne atteint un puits. Elle est utile pendant la migration d'un vieux code, mais c'est aussi un endroit où les erreurs se cachent, donc garde-la stricte et journalise ce qui y passe.
Prise en charge et déploiement
Les Trusted Types sont pris en charge par tous les grands moteurs : les navigateurs basés sur Chromium, Safari 26 et Firefox 148 (vérifié en octobre 2026). Les visiteurs sur des navigateurs plus anciens n'ont simplement pas la vérification en plus, donc garde l'échappement et ta CSP à base de nonces. Le code peut le tester avec if (window.trustedTypes).
Déploie-le comme n'importe quelle politique : envoie d'abord require-trusted-types-for 'script' dans un en-tête Content-Security-Policy-Report-Only. Chaque chaîne qui atteint un puits est signalée, ce qui te montre exactement quelles lignes ont besoin d'une politique ou, mieux, d'un passage à textContent.
Une idée reçue : « les Trusted Types nettoient le HTML pour moi ». Ils ne nettoient rien. Ils forcent les chaînes à passer par ta politique. Une politique qui renvoie son entrée inchangée (createHTML: s => s) passe la vérification et ne protège rien.
Récap
- L'injection par le DOM se produit dans ton propre JavaScript, dans des puits comme
innerHTML; les règles sur les balises de script seules ne l'attrapent pas. require-trusted-types-for 'script'fait refuser les simples chaînes aux puits ;trusted-types NAMElimite les politiques qui peuvent exister.- Relis les quelques fonctions de politique au lieu de chaque puits, et préfère
textContentquand tu peux. - Pris en charge par tous les grands moteurs (vérifié en octobre 2026) ; déploie d'abord en report-only.
Tu as repéré un problème dans cette leçon ? Signale-le · Pose une question sur cette leçon
Cet exercice s'ouvre bientôt
Termine la leçon précédente pour débloquer celle-ci. Tout le cours est gratuit, aucun compte n'est requis, et tu peux lire cette leçon dès maintenant.
Ce navigateur bloque les cookies pour learn.floati.life, donc les leçons que tu as terminées ici ne peuvent pas s'ouvrir dans l'ordre. Autorise les cookies pour ce site et recharge la page.