Fingerprinting par mesure de texte : suivi sous-pixel
Canvas measureText() expose des metriques de texte qui varient selon les plateformes. BotBrowser garde ce comportement aligne sur le profil pour proteger la coherence d'identite.
BotBrowser Team
Vous voulez la documentation structurée pour Empreinte ?
Cet article fait partie de la bibliothèque éditoriale. Pour les étapes de configuration, la référence et les mises à jour continues, passez directement à la section docs.
BotBrowser peut aligner les metriques texte et Canvas prises en charge sur un profil charge, mais il ne controle pas la collecte du site et ne promet pas des valeurs identiques pour tous les navigateurs, polices et environnements graphiques.
Watch the video
Cette vidéo en anglais suit la même question que l'article : elle lit les valeurs de largeur et de boîte englobante renvoyées par measureText() de Canvas pour des chaînes déclarées, montre comment un sélecteur de variation et une séquence Emoji jointe modifient le résultat, et garde la comparaison dans un banc d'essai local contrôlé. Elle ne montre aucune collecte par un site, et une seule mesure ne constitue pas une identité unique. Le regroupement des métriques emoji CreepJS a une autre limite : les représentants de géométries égales ne constituent pas une liste complète des glyphes pris en charge.
Les listes de fragments DOMRect décrivent la disposition, pas les métriques des glyphes Canvas ; l'analyse de cohérence de getClientRects distingue la géométrie Element et Range ainsi que les listes vides.
TL;DR
La mesure de texte expose des valeurs numériques de largeur et de limites qui dépendent du navigateur, des polices, de la langue et du chemin graphique. Un profil BotBrowser chargé peut rendre les mesures prises en charge plus reproductibles dans les conditions documentées, sans contrôler la collecte du site ni promettre une sortie identique partout.
Sommaire
Introduction
Lorsqu'un site web mesure la largeur d'une chaine de texte en utilisant la methode measureText() de l'API Canvas, le resultat est une valeur a virgule flottante avec une precision sous-pixel. Ces valeurs varient selon les systemes d'exploitation car chaque plateforme utilise un moteur de rendu integre different avec son propre modele arithmetique interne. Les differences sont infimes, invisibles a l'oeil nu, mais elles sont coherentes, reproductibles et mesurables via JavaScript.
Cette precision sous-pixel fait de measureText() un signal observable que les scripts peuvent comparer. Contrairement au fingerprinting d'image Canvas, il renvoie des metriques numeriques sans lecture de pixels. Le collecteur SVG de CreepJS utilise une autre API, getComputedTextLength() ; sa carte des champs explique cette mesure distincte. Il n'identifie pas a lui seul un systeme d'exploitation : les polices, la version du navigateur, la locale, les graphismes et le mode d'execution comptent aussi.
La mesure de texte est un signal observable que les scripts de fingerprinting peuvent collecter sur de nombreux types de sites. Elle ne necessite aucune permission speciale et ne genere aucun comportement visible, mais sa stabilite depend de la session et du deploiement. Les changements au niveau de l'API peuvent affecter le comportement des applications web.
L'approche alignee sur le profil de BotBrowser
BotBrowser peut aligner le comportement texte et Canvas pris en charge sur le profil charge. Le resultat depend encore de la version du navigateur, des polices disponibles, de la locale, du chemin graphique et du mode d'execution ; un site peut encore observer des differences.
Chemin de rendu de polices unifie
Les reglages du profil s'appliquent au chemin de mesure de texte pris en charge afin de permettre une comparaison avec l'environnement declare. Verifiez la version et l'ensemble de polices du deploiement avant d'interpreter une difference.
Lorsqu'un profil specifie une configuration d'appareil, utilisez measureText() avec des controles Canvas et CSS pour verifier le comportement documente. Les polices de l'hote et la version du navigateur font toujours partie du resultat.
Coherence pilotee par le profil
Chaque profil de fingerprint BotBrowser decrit le comportement pris en charge des metriques de texte pour un environnement declare. Lorsque le profil est charge, les mesures peuvent etre comparees a cette declaration :
- La meme chaine et les memes reglages typographiques peuvent etre compares entre executions si le profil, la version, les polices, la locale et le mode d'execution restent constants.
- Le meme profil peut maintenir des valeurs
measureText()conformes a la politique documentee sur macOS, Windows et Linux ; verifiez les valeurs exactes pour la version et les polices deployees. - Les resultats sont internement coherents avec d'autres signaux lies aux polices (liste de polices, rendu de texte Canvas, metriques de mise en page CSS).
Verifiez chaque propriete TextMetrics utilisee par votre application. La prise en charge et les valeurs peuvent varier selon la version du navigateur, les polices et le mode graphique.
Coherence multiplateforme et limites
L'objectif est une coherence alignee sur le profil entre les plateformes prises en charge. Les valeurs flottantes exactes peuvent encore dependre de la version du navigateur, des polices, de la locale, de la pile graphique et du mode d'execution ; une comparaison multiplateforme reste donc une validation, pas une garantie universelle.
La comparaison n'est utile qu'avec des variables de deploiement controlees. Les extensions, proxies d'API et wrappers JavaScript ne determinent pas la sortie exacte du navigateur du site ; validez donc l'ensemble de la configuration. Un autre signal observable du navigateur, qui dépend de l'environnement d'exécution, est présenté dans Profondeur de pile JavaScript : un signal de confidentialité.
Le profil definit le comportement attendu dans ses limites documentees ; les preferences de polices et de graphismes de l'hote peuvent modifier la sortie.
Comportement observable et limites de confidentialite
Le comportement observable reste celui des API Canvas publiques :
measureText()renvoie des valeurs JavaScriptNumbernatives avec une precision complete en virgule flottante double precision via l'API standard.- Comparez les valeurs avec Canvas et CSS dans le meme deploiement ; de petits ecarts peuvent etre legitimes.
- BotBrowser n'empeche pas un site de collecter ou transmettre ces valeurs et ne decide pas comment il les stocke ou les interprete.
Coherence interne avec d'autres signaux
La protection des metriques de texte n'opere pas isolement. Utilisez le profil comme reference pour comparer measureText() aux autres signaux de polices et de rendu observables. Si un script de suivi valide les metriques de texte par rapport a la sortie de pixels Canvas, a l'enumeration des polices ou aux mesures de mise en page CSS, evaluez les differences dans l'ensemble du deploiement.
Configuration et utilisation
Utilisation CLI
Lancez BotBrowser avec un profil de fingerprint pour activer la protection de mesure de texte :
chrome --bot-profile="path/to/profile.enc" \
--user-data-dir="$(mktemp -d)"
Pour des resultats deterministes entre les executions, ajoutez une graine de bruit :
chrome --bot-profile="path/to/profile.enc" \
--bot-noise-seed=12345 \
--user-data-dir="$(mktemp -d)"
Combinez avec les parametres de fuseau horaire, de localisation et de proxy pour une coherence d'identite complete :
chrome --bot-profile="path/to/profile.enc" \
--bot-noise-seed=12345 \
--proxy-server="socks5://user:pass@proxy:1080" \
--bot-timezone="America/New_York" \
--bot-locale="en-US" \
--bot-languages="en-US,en"
Integration Playwright
const { chromium } = require('playwright-core');
(async () => {
const browser = await chromium.launch({
executablePath: 'path/to/botbrowser/chrome',
args: ['--bot-profile=path/to/profile.enc', '--bot-noise-seed=42'],
headless: true,
});
const context = await browser.newContext({ viewport: null });
const page = await context.newPage();
await page.goto('https://example.com');
// measureText() results will be consistent with the loaded profile
const metrics = await page.evaluate(() => {
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d');
ctx.font = '16px Arial';
const measurement = ctx.measureText('Sample text for measurement');
return {
width: measurement.width,
actualBoundingBoxAscent: measurement.actualBoundingBoxAscent,
actualBoundingBoxDescent: measurement.actualBoundingBoxDescent,
};
});
console.log('Text metrics:', metrics);
await browser.close();
})();
Integration Puppeteer
const puppeteer = require('puppeteer-core');
(async () => {
const browser = await puppeteer.launch({
executablePath: 'path/to/botbrowser/chrome',
args: ['--bot-profile=path/to/profile.enc', '--bot-noise-seed=42'],
headless: true,
defaultViewport: null,
});
const page = await browser.newPage();
await page.goto('https://example.com');
// Verify text measurement from the loaded profile
const metrics = await page.evaluate(() => {
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d');
ctx.font = '16px Arial';
const m = ctx.measureText('Sample text for measurement');
return { width: m.width };
});
console.log('Text width:', metrics.width);
await browser.close();
})();
Fixture pratique
Conservez un petit fixture local afin qu'une variation ait une cause vérifiable. Attendez les polices web, fixez l'état Canvas et gardez les valeurs brutes sans arrondi :
await page.evaluate(async () => {
await document.fonts.ready;
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d', { alpha: false });
ctx.font = '16px Arial';
ctx.direction = 'ltr';
ctx.textAlign = 'start';
ctx.textBaseline = 'alphabetic';
const sample = 'Aa 123, مرحبا, 世界';
const m = ctx.measureText(sample);
return {
sample,
font: ctx.font,
width: m.width,
actualBoundingBoxAscent: m.actualBoundingBoxAscent,
actualBoundingBoxDescent: m.actualBoundingBoxDescent,
devicePixelRatio: window.devicePixelRatio,
visualViewportScale: window.visualViewport?.scale ?? 1,
};
});
Exécutez le fixture dans un navigateur de contrôle et dans le déploiement profilé avec la même version, les mêmes polices, locale, zoom et mode. Une variation est un indice à examiner, pas la preuve qu'un site peut ou ne peut pas identifier une personne.
Verification
Apres avoir lance BotBrowser avec un profil, verifiez que la protection de mesure de texte est active :
const width = await page.evaluate(() => {
const canvas = document.createElement('canvas');
const ctx = canvas.getContext('2d');
ctx.font = '16px Arial';
return ctx.measureText('Verification string').width;
});
console.log('Text width:', width);
Points a verifier :
- La valeur de largeur est un nombre a virgule flottante de precision complete, comparable a la plateforme declaree du profil dans les conditions documentees.
- Recharger la page et repeter la mesure produit la meme valeur.
- Redemarrer le navigateur avec le meme profil et la meme graine de bruit produit la meme valeur.
- Comparez le resultat avec des controles Canvas et CSS maitrises ; les pages tierces peuvent evoluer independamment.
Meilleures pratiques
Toujours utiliser un profil complet
La protection de mesure de texte fonctionne dans le cadre du profil complet de fingerprint de BotBrowser. Le profil fournit une reference pour les metriques prises en charge ; confrontez-la au rendu Canvas, aux polices disponibles et a la mise en page CSS. Charger un profil est necessaire pour activer ce comportement.
Combiner avec l'identite reseau
Les metriques de texte peuvent renseigner sur l'environnement. Les signaux reseau apportent un contexte de localisation. Pour comparer des deploiements, combinez le profil de fingerprint avec les parametres de proxy et de localisation appropries :
chrome --bot-profile="path/to/profile.enc" \
--proxy-server="socks5://user:pass@proxy:1080" \
--bot-timezone="Europe/London" \
--bot-locale="en-GB" \
--bot-languages="en-GB,en"
Utiliser le mode deterministe pour les tests
Lors de l'execution de tests automatises ou d'experiences de recherche, utilisez --bot-noise-seed pour garantir des resultats reproductibles. Cela vous permet de verifier que les metriques de texte restent stables entre les executions de test et de detecter toute regression dans la coherence des metriques.
Tester avec plusieurs configurations de polices
Lors de la verification de la protection, testez avec une variete de familles de polices et de tailles. Incluez a la fois les polices web courantes et les valeurs par defaut du systeme dans votre ensemble de tests. Cela garantit une couverture complete de la coherence des metriques de texte de votre profil dans la gamme de polices que les scripts de suivi sondent generalement.
Maintenir les profils et BotBrowser a jour
Le fingerprinting par mesure de texte continue d'evoluer. De nouvelles proprietes TextMetrics ont ete ajoutees dans les versions recentes du navigateur, et les scripts de suivi mettent a jour leur collecte pour inclure ces nouveaux signaux. Gardez votre installation BotBrowser et vos profils a jour pour assurer la couverture des proprietes nouvellement exploitables.
La chaine complete de police fait partie de l'entree. Notez le style, le poids, la taille, la variante, la famille et l'etat de document.fonts.ready; une police de remplacement peut modifier tous les avances de glyphes. Avant de mesurer le texte ou la mise en page, attendez la fin du chargement des polices, car un remplacement tardif peut modifier les metriques des glyphes et les retours a la ligne. Le chargement des polices web et la stabilite de la mise en page decrit cette relation.
Separez les echantillons par ecriture lorsque c'est pertinent. Conservez un corpus versionne Latin, Cyrillic, Arabic ou CJK, ainsi que la ponctuation, les marques combinees, les emoji et le texte bidirectionnel utiles au produit.
Notez devicePixelRatio, visualViewport.scale, les dimensions du canvas, le zoom de page et l'echelle du systeme. measureText() utilise les coordonnees CSS, tandis que les pixels observent aussi le buffer et la rasterisation.
Reinitialisez l'etat Canvas avant chaque test : police, direction, alignement et ligne de base. Comparez une page de controle et une page profilee avec la meme version, les memes polices, locale et mode headed/headless ; une variation demande une verification avant toute attribution.
Les permissions, le stockage, la CSP ou le blocage des polices web peuvent empecher une sonde d'aboutir. Conservez l'etat reseau et les permissions, gardez les echantillons localement et comparez TextMetrics, raster Canvas, DOM et evenements de police. Pour gérer les URL externes de façon sûre dans un environnement de test similaire, consultez Gestion sûre des URL externes pour les profils.
FAQ
Qu'est-ce que le fingerprinting par mesure de texte ?
Le fingerprinting par mesure de texte utilise l'API Canvas measureText() pour comparer le comportement de rendu. Elle renvoie des largeurs sous-pixel qui peuvent varier selon le navigateur, les polices, la locale, les graphismes et le mode d'execution. Un ensemble de signaux peut suggerer des caracteristiques de l'environnement, mais une mesure seule n'identifie pas un systeme d'exploitation ni un appareil.
En quoi est-ce different du fingerprinting Canvas ?
Le fingerprinting Canvas rend du contenu visuel (texte, formes, degrades) sur un element Canvas et hache les donnees de pixels resultantes. Le fingerprinting par mesure de texte utilise measureText() pour obtenir des valeurs de largeur numeriques sans rien rendre de visible. La mesure de texte est plus rapide, produit un resultat numerique direct et fournit un type de signal different. Les deux techniques reposent sur des differences de rendu specifiques a la plateforme, mais elles operent sur differentes sorties de l'API Canvas. Vous pouvez en apprendre plus sur le fingerprinting Canvas dans notre guide Canvas Fingerprinting.
BotBrowser produit-il les memes valeurs sur toutes les plateformes ?
BotBrowser vise a maintenir measureText() coherent avec le profil charge sur les plateformes prises en charge. Le resultat reste borne par la version du navigateur, les polices disponibles, la locale et le mode headless ou avec interface ; comparez donc le deploiement exact au lieu de supposer une identite octet par octet.
La protection de mesure de texte casse-t-elle les sites web ?
Non. BotBrowser ne bloque ni ne modifie l'API measureText(). L'API fonctionne normalement, renvoyant des valeurs de largeur de texte precises que les applications web peuvent utiliser pour la mise en page, la troncature de texte, le rendu de graphiques et tous les autres usages legitimes. Les valeurs sont simplement coherentes avec le profil charge plutot qu'avec le rendu natif du systeme hote.
Comment cela se rapporte-t-il au fingerprinting de polices ?
Le fingerprinting par mesure de texte est etroitement lie au fingerprinting de polices mais cible un signal different. Le fingerprinting de polices identifie quelles polices sont installees en verifiant si des familles de polices specifiques sont disponibles. Le fingerprinting par mesure de texte identifie comment le moteur de rendu traite ces polices en examinant les valeurs de metriques sous-pixel. Les deux signaux sont derives de la pile de rendu de polices, et les deux sont couverts par la protection sur le chemin de rendu de BotBrowser. Pour un apercu plus large, consultez notre article sur le fingerprinting de navigateur.
Puis-je utiliser la protection de mesure de texte de BotBrowser avec des frameworks d'automatisation existants ?
Oui. BotBrowser s'integre avec Playwright, Puppeteer, Selenium et d'autres frameworks d'automatisation. La protection de mesure de texte est automatiquement active lorsqu'un profil de fingerprint est charge. Aucune configuration supplementaire ni modification de code n'est necessaire au-dela du passage du flag --bot-profile. Consultez le guide de demarrage Playwright et le guide de demarrage Puppeteer pour les instructions de configuration.
Cette protection couvre-t-elle toutes les proprietes TextMetrics ?
BotBrowser prend en charge les proprietes TextMetrics documentees, notamment width, les champs de bounding box et les champs d'ascendance/descendance. La disponibilite et les valeurs exactes dependent de la version du navigateur, des polices, des graphismes, de la locale et du mode d'execution ; validez les champs utilises dans votre deploiement.
Resume
Pour la synthèse, conservez la police, la locale, l'échelle, la version du navigateur et les champs TextMetrics comparés. Une variation de width ou de bounding box doit être reliée à l'un de ces inputs avant d'être interprétée.
BotBrowser aborde ce signal en appliquant le profil charge au comportement texte et Canvas pris en charge. Validez le resultat avec la version, les polices, la locale, les graphismes et le mode d'execution de production ; des differences entre hotes restent possibles et l'interpretation du site echappe au profil.
Combinée avec la protection de BotBrowser pour le rendu Canvas, l'énumération de polices et la cohérence des profils multiplateformes, la protection de mesure de texte traite un signal de fingerprinting utilisé par les systèmes de suivi.
Capacité et Limitations de BotBrowser
BotBrowser peut aligner le comportement Canvas measureText() pris en charge sur un profil charge, sous reserve des contraintes documentees du navigateur, des polices, des graphismes et du mode d'execution. Il ne peut pas empecher les sites de collecter ou transmettre ces valeurs, controler leur stockage ou interpretation, ni couvrir les signaux hors profil. Les comparaisons reproductibles exigent le meme profil, les memes options, les memes polices et le meme protocole.
Conclusion pratique
Avant de dépendre de ces mesures, figez la version du navigateur, le profil, les polices, la langue, le mode graphique et le mode d'exécution. Comparez tout le résultat TextMetrics avec Canvas et CSS, puis considérez-le comme un signal parmi une évaluation plus large de confidentialité et de compatibilité.
Sources Publiques
Cet article fait partie du guide : Qu'est-ce qu'une empreinte de navigateur ?
Articles Connexes
Empreinte getClientRects : cohérence DOMRect
EmpreinteMétriques emoji CreepJS : ensembles et sommes
EmpreinteQu'est-ce que l'empreinte des polices ? Cohérence du texte
EmpreinteWebGL fingerprinting : webgl_debug_renderer_info et votre GPU
EmpreinteMesures SVG de CreepJS : champs et limites
EmpreinteFingerprinting WebGPU : la nouvelle génération de pistage GPU
Exécutez la même vérification dans BotBrowser
Chargez un profil, gardez dans le navigateur les signaux que vous venez de lire, puis confirmez le résultat sur votre propre machine avant le déploiement.