
DarkAbsolut
Thème sombre automatique pour les sites qui n’en proposent pas
Extension navigateurDébut : juin 2026JavaScriptWebExtensions (Manifest V3)Filtres CSS et SVGChromeFirefoxPlaywright
Code source Site du projet Chrome Web Store Firefox Add-ons Microsoft Edge Add-ons
Extension Chrome, Firefox et Edge (Manifest V3) qui assombrit les sites dépourvus de thème sombre et laisse intacts ceux qui en ont déjà un. Images, vidéos et icônes colorées gardent leurs vraies couleurs ; réglages globaux ou par domaine, raccourcis clavier, import et export de la configuration.
But du projet
Naviguer de nuit sans dépendre du thème de chaque site. L’extension inverse les pages claires par un filtre CSS, rend leurs vraies couleurs aux contenus visuels et repère les sites déjà sombres pour ne pas les toucher. Elle est publiée sous l’organisation GitHub Extension-Crafters, sur le Chrome Web Store, Firefox Add-ons et Microsoft Edge Add-ons ; Opera et Brave installent la version Chrome.
Fonctionnalités
- Mode sombre automatique :
filter: invert(1) hue-rotate(180deg)sur<html>, puis ré-inversion des images, vidéos, embeds, canvas,<image>SVG et éléments à image de fond, y compris dans les shadow roots ouverts. Les iframes ne sont volontairement pas ré-inversées, pour que leur contenu HTML (corps d’un message dans Gmail, fenêtre de rédaction) s’assombrisse avec la page. - Détection des sites déjà sombres : respect de
color-scheme: dark, échantillonnage du fond réellement peint sur une grille de points de la fenêtre, repli sur le fond de<body>et<html>. - Couleurs porteuses de sens : les petits pictogrammes colorés (étoiles de notation, icônes d’état) passent par un filtre SVG « accent » qui garde les couleurs vives dans leur teinte, si bien qu’une étoile dorée reste dorée. Le texte coloré peu contrasté est éclairci dans sa propre teinte, et les petits aplats saturés (boutons, badges) gardent leur couleur.
- Trois modes pour le bouton de la barre d’outils : filtrage par site (par défaut), application ponctuelle à la page au clic, ou bascule globale marche/arrêt.
- Réglages globaux ou par hôte, avec ou sans ses sous-domaines, pour le mode sombre, les images naturelles (garder les couleurs d’origine de toutes les images) et le gris sombre doux (remonter le noir pur en gris foncé), plus un interrupteur général.
- Délai de réanalyse des pages qui changent : 250 ms par défaut, de 60 à 5 000 ms, global ou par site.
- Raccourcis clavier enregistrés depuis la fenêtre de l’extension (Ctrl, Alt ou AltGr plus une touche) pour basculer le site courant ou l’interrupteur général, avec plusieurs combinaisons possibles par action.
- Page d’options listant chaque domaine personnalisé, et import/export de toute la configuration en JSON.
- Aucune donnée collectée, ce que déclare le manifeste pour Firefox (
data_collection_permissions).
Fonctionnement
- Le script de contenu s’exécute dès
document_startdans tous les cadres. Il pose l’inversion par anticipation pour qu’une page claire ne s’affiche jamais en blanc, puis réévalue la page à plusieurs étapes (chargement des feuilles de style,DOMContentLoaded,load, vérifications différées) et retire l’inversion si le site se révèle déjà sombre. Il suit aussi les changements de classe de thème sur<html>et<body>, et ceux deprefers-color-scheme. - Un
MutationObservertraite les nœuds ajoutés par la page, une fois qu’elle a cessé de changer pendant le délai de réanalyse. src/content/regroupe des scripts classiques injectés dans l’ordre : espace de noms partagé, calculs de couleur (luminance, HSL, contraste), détection, génération du CSS, traitement élément par élément, contrôleur.src/background/est un service worker en modules ES : stockage danschrome.storage.local, règles d’URL et de domaine, badge, routage des messages.- Chrome refuse
background.scriptset Firefoxbackground.service_worker: le manifeste du dépôt vise Chrome, etpackage-extension.shproduit une archive par boutique, la version Firefox déclarant une page d’événements avec le même point d’entrée.
Captures d’écran
Tests
Les tests Playwright chargent l’extension non empaquetée dans Chromium sans interface (canal chromium et --headless=new, car chrome-headless-shell ne charge pas d’extensions). npm test enchaîne 36 scripts, chacun consacré à un cas délicat : shadow DOM, médias imbriqués, pseudo-éléments, dégradés, iframes, canvas de cartes, raccourcis, popup… S’y ajoutent :
- un audit visuel qui mesure la luminance des pixels réellement rendus (moyenne, part de pixels clairs, bande d’en-tête) et se compare à une référence pour repérer les régressions ;
- un audit des images qui vérifie la parité d’inversion : un média doit traverser un nombre pair de filtres
invert, sinon il s’affiche en négatif ; - un audit de terrain sur des sites très fréquentés : captures avec l’extension active puis désactivée sur le même chargement, analyse au pixel (images en négatif, texte devenu illisible, blocs restés clairs, résidus après désactivation) et mesure des tâches longues avec et sans l’extension.
Installation
Depuis les boutiques : Chrome Web Store (aussi pour Opera et Brave), Firefox Add-ons, Microsoft Edge Add-ons.
En développement :
- Chrome, Edge, Brave : ouvrir
chrome://extensions, activer le mode développeur et charger le dossier non empaqueté. Pour assombrir des pagesfile://, activer l’accès aux URL de fichiers dans les détails de l’extension. - Firefox 121 ou plus : construire les archives, puis charger
DarkAbsolut-firefox.zipcomme module temporaire depuisabout:debugging#/runtime/this-firefox.
./package-extension.sh # DarkAbsolut-chrome.zip et DarkAbsolut-firefox.zip
npm install
npx playwright install chromium
npm testLimites connues
- Le filtre CSS est rapide et universel mais n’égale pas un thème sombre fait à la main : un site très personnalisé peut avoir un rendu inhabituel, auquel cas on désactive l’extension sur ce domaine.
- Un site qui ne peint son fond sombre qu’après le premier affichage peut apparaître brièvement inversé ; recharger la page le réévalue.
- Une règle « sous-domaines » est enregistrée sur l’hôte saisi : pour la retirer depuis un sous-domaine qu’elle couvre, il faut se rendre sur l’hôte parent.


