Options de lancement
Les options de lancement qui ne sont pas traitées sur les autres pages : extensions, Privacy Sandbox et le reste de la liste.
Autres options de lancement
extensions— une liste de chemins de répertoires d’extensions non empaquetées (génère--load-extension+--disable-extensions-except).disablePrivacySandbox/disable_privacy_sandbox— metteztruepour désactiver les API Privacy Sandbox (Topics, FLEDGE / Protected Audience, Shared Storage, Private Aggregation, Fenced Frames). Option désactivée par défaut depuis la 0.23 : la persona par défaut se présente comme Google Chrome, qui les embarque toutes. Ne l’activez que si la persona est un Chromium dégooglisé. WebUSB n’est pas concerné.agentTyping/agent_typing— la cadence de frappe de l’agent (humanpar défaut /fast/instant). Voir Agent.tlsProfile— maintient le ClientHello TLS cohérent avec la version de Chrome annoncée par la persona, pour que la couche réseau suive l’UA (et non le TLS natif du build). La valeur par défaut,"match-persona", suitbrandVersion;"native"n’y touche pas ;"chrome-<major>"épingle une version majeure. Voir Flags d’empreinte.platform: "android"— une persona mobile en best effort (tactile, pointeur coarse, écran/DPR mobile, WebGL Mali/Adreno, viewport de téléphone). Sur un moteur desktop, le rendu GPU reste celui d’un desktop — associez-le au canvas bridge pour la cohérence du rendu.storageQuota,fingerprintProfile,canvasBridge,webrtcIp,acceptLanguage,disableGpuFingerprint,fingerprintNoise— voir Flags d’empreinte.
Options récentes (build sous licence)
Elles nécessitent le build sous licence (Gratuit avec GitHub ou Pro). La révision du moteur requise pour chacune figure entre crochets ; sur un moteur plus ancien, le SDK écarte celles de la 152 r22 avec un avertissement, vérifie le moteur pour chacune de celles de la 154 r32 et la laisse désactivée si le build ne la prend pas en charge, et le moteur ignore les autres.
stockRuntime/stock_runtime/StockRuntime(ouCLEARCOTE_STOCK_RUNTIME=1) — rend à Playwright le comportement DevTools d’origine le temps d’une session de débogage : les événements de console et d’erreur de page,page.setContent()etexposeFunction()après une navigation. Désactivé par défaut, car les pages peuvent l’observer ; un moteur dépourvu de ce switch se lance sans lui et le SDK avertit une fois. Lancements locaux et Docker uniquement. Voir Événements et débogage. [154 r32 ; SDK 0.41.0]personaEnv/persona_env/PersonaEnv— activé par défaut depuis le SDK 0.41.0. Les switches de la persona (la seed, chaque surcharge de persona, les identifiants du proxy et le jeton du canvas bridge) parviennent au navigateur par son environnement plutôt que par sa ligne de commande, que n’importe quel utilisateur local peut lire dans la liste des processus (/proc/<pid>/cmdlinesous Linux, les détails du processus sous Windows). Le moteur les retire aussi des lignes de commande de ses processus auxiliaires.falseouCLEARCOTE_PERSONA_ENV=0les laisse sur la ligne de commande, par exemple pour un outil à vous qui les y lit. L’image Docker fait de même pour le navigateur du conteneur. [154 r32]- Jeton de persona — sur la version sous licence de Chromium 156 (r51 et suivantes), le SDK récupère à chaque lancement une persona signée pour votre seed ou votre profil auprès du service de personas Clearcote et la transmet au navigateur avec les switches ci-dessus. Cela ne se désactive pas ; sans jeton, le navigateur ne démarre pas. Nécessite le SDK 0.63.0, Profile Manager 0.27.0 ou l'image Docker correspondante. [156 r51 ; SDK 0.63.0]
- Clair ou sombre — depuis la 154 r32, la persona détermine le thème de couleurs (environ un profil sur trois préfère le sombre), et le CSS,
matchMedia, l’en-tête de requêteSec-CH-Prefers-Color-Schemeet les couleurs système le suivent tous. Playwright émule le thème clair dans chaque contexte qu’il crée, ce que contredirait une persona sombre ; depuis le SDK 0.41.0, les contextes créés par un lancement local laissent donc le thème de couleurs tel quel sur un tel build. PassezcolorScheme/color_scheme/ColorSchemepour en émuler un malgré tout, ou--fingerprint-color-scheme=light|darkdansargspour rendre la persona elle-même claire ou sombre. Un build plus ancien conserve le comportement par défaut de Playwright. [154 r32] allowThirdPartyCookies/allow_third_party_cookies— cookies tiers, autorisés par défaut comme dans Chrome d’origine (SDK 0.45.0+).falseles bloque. Les frames intégrées de connexion, de paiement et de challenge en dépendent. Les builds antérieurs à 152 r22 les bloquent toujours. [152 r22]transparentProxy/transparent_proxy— masque le proxy dans les en-têtes des requêtes et dans le timing des connexions (les requêtes HTTP en clair ne portent aucun en-tête de proxy ; les connexions via le proxy présentent le timing d’une connexion réutilisée). Nécessite un proxy. [152 r22]fingerprintVoices: false/fingerprint_voices=False— conserve les voix de synthèse de cette machine au lieu de la liste de la persona. [152 r22]fingerprint: "off"— lance le navigateur sans aucune persona, pour le dépannage. [152 r22]socks5Udp/socks5_udp— fait passer l’UDP de WebRTC par un proxysocks5://: la voix, la vidéo et les connexions pair à pair fonctionnent tout en sortant par l’adresse du proxy. Le proxy doit l’autoriser ; beaucoup de pools résidentiels ne le font pas. [151 r17]portableProfile/encryptionKey— des profils copiables d’une machine à l’autre (voir plus haut). [151 r14 ; Python, Node & .NET (0.58.0+)]personaSchema/persona_schema— le modèle d’identité que dérive une seed. Ne le définissez pas pour utiliser le modèle actuel,7(servi depuis le 2026-10-26, r52) : la carte graphique détermine le type de machine (portable ou de bureau), son processeur, ses threads, sa mémoire et son écran, chacun aussi courant que dans le trafic réel des navigateurs.5dérive exactement ce que dérivaient les builds r45 à r51,4ce que dérivaient les builds 154 r37 à 155 r44,3ce que dérivait la 154 r36 et2ce que dérivaient les builds 153 r29 à 154 r35 ; choisissez-en un pour conserver les identités créées avec ces builds.1est le modèle d’origine, antérieur à la r29. Il n’existe pas de6. Tous les SDK acceptent 5 et 7 depuis la 0.64.1. Voir la même seed sur des machines différentes. N’ajoutezrealGpuHost/real_gpu_hostque sur une machine dotée d’une vraie carte graphique. [151 r19 ; Python, Node & .NET]shaderDialect: "hlsl"— activée par défaut pour une persona Windows sur un hôte Linux ou macOS depuis le SDK 0.39.0 ;falsela désactive. Voir Dialecte de shader. [151 r15]profile: "auto"— lance une vraie empreinte capturée, choisie pour cette machine, au lieu d’une seed ; ajustez le choix avecprofileSelect/profile_select. Python, Node & .NET (LocalProfile = "auto", 0.58.0+). En Node, cela fonctionne avec lelaunch()par défaut,launchPersistentContext()etserve()à partir du SDK 0.31.1 ; les versions 0.31.0 et antérieures exigeaientephemeralProfile: falseet échouaient avecserve().
Non liées à un build du moteur :
version/releaseChannel— choisit un build ; voir choisir un build.licenseKey/license_key/LicenseKey— la clé de licence, si elle ne se trouve ni dansCLEARCOTE_LICENSE_KEYni dans~/.clearcote/license.key.licenseThroughProxy/license_through_proxy(ouCLEARCOTE_LICENSE_THROUGH_PROXY=1) — envoie les appels de licence via le proxy du lancement plutôt que depuis cette machine.ephemeralProfile/userDataDirsurlaunch()— voir la remarque sous La méthode SDK plus haut.widevine: true— lecture DRM (les deux builds) ; voir Widevine & DRM.quiet— masque les avertissements de lancement et l’affichage de la progression du SDK.fontDirs/font_dirs/FontDirs— vos propres polices sous Linux ; voir ci-dessous.
Vos propres polices sous Linux (fontDirs)
Sous Linux, le navigateur ne voit que les polices que le SDK lui indique : le bundle de sosies de la version, aux métriques compatibles avec celles de Windows (Arial→Arimo, Segoe UI→Selawik, Times New Roman→Tinos, …). Aucune police installée sur l’hôte ne lui parvient, si bien que rien sur la machine ne peut modifier ce qu’une page mesure. Depuis le SDK 0.41.0 (Python, Node et .NET ; launch(), les contextes persistants et serve()), deux réglages ajoutent des répertoires :
fontDirs/font_dirs/FontDirs, ouCLEARCOTE_FONT_DIRS— vos propres polices, typiquement une copie du dossierC:\Windows\Fontsd’une machine Windows, placées avant le bundle. Sur le build sous licence à partir de la 154 r32, chaque famille qu’elles fournissent s’affiche telle quelle, sous son propre nom, au lieu de son sosie, et les noms qui la représentent sous Windows suivent : Helvetica, Times et Courier, ainsi que les familles génériques CSS (sans-serif→ Arial,serif→ Times New Roman,monospace→ Consolas,system-ui→ Segoe UI). Un moteur plus ancien continue de dessiner ses sosies pour les familles que liste une persona, et n’utilise les répertoires que pour les caractères que rien d’autre ne couvre. Un chemin qui n’est pas un répertoire fait échouer le lancement immédiatement, avant qu’un slot de licence soit pris.CLEARCOTE_FALLBACK_FONT_DIRS— des polices utilisées uniquement pour les caractères que rien d’autre ne couvre (CJK, écritures indiennes, emoji, …), placées après le bundle. Elles ne prennent la place d’aucune famille. L’image Docker la définit avec les polices d’écritures qu’elle embarque.
from clearcote import launch
# a copy of a Windows machine's C:\Windows\Fonts, on the Linux host
browser = launch(fingerprint="acct-1", platform="windows", font_dirs=["/srv/windows-fonts"])
# or: CLEARCOTE_FONT_DIRS=/srv/windows-fonts (several directories: separate them with ":")- Les deux variables sont des listes séparées par
:. Les noms de famille sont lus dans les fichiers de police eux-mêmes, si bien qu’aucun outil fontconfig n’est nécessaire. Ne pointez jamais l’une ou l’autre vers l’ensemble de/usr/share/fonts: les familles latines de l’hôte entrent alors en concurrence avec le bundle et modifient les largeurs que rapporte une persona Windows. clearcote info(Python et Node) indique, sous Linux, lesquels des 29 systèmes d’écriture les polices que verrait un lancement savent dessiner, vos répertoires de polices, et lesquelles des principales familles Windows elles fournissent réellement.- Pour conserver les sosies même avec vos polices listées, passez
--disable-genuine-font-facesdansargs(154 r32+). Le SDK le détecte et laisse ses propres règles de polices telles quelles, de sorte que le moteur et fontconfig s’accordent sur chaque famille. - Ignoré sous Windows et macOS, qui utilisent leurs propres polices, et refusé pour un lancement cloud et pour le lancement Docker macOS : dans votre propre conteneur, montez les polices et définissez-y
CLEARCOTE_FONT_DIRS(voir Déploiement). N’utilisez que des polices dont vous détenez la licence. - Avant la 0.41.0, le SDK .NET n’indiquait pas du tout le bundle au navigateur, si bien qu’un lancement .NET sous Linux utilisait les polices de l’hôte et aucun des sosies. Il s’aligne désormais sur Python et Node, ce qui change ce qu’une persona Windows y mesure.