Retour au Centre de connaissances
Identité

Hygiène des données et de l’état pour l’automatisation du navigateur

Attribuez clairement les données synthétiques, l’état du navigateur et le nettoyage à chaque worker isolé.

BotBrowser Team

Documentation

Vous voulez la documentation structurée pour Identité ?

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.

Schéma d’un fixture synthétique passant par un contexte isolé jusqu’à un résultat visible et son nettoyage

Un test fiable nomme chaque entrée, propriétaire, résultat observable et limite de nettoyage. Un contexte neuf n’isole pas un compte partagé, un enregistrement serveur ou un répertoire de téléchargement. Utilisez des données synthétiques créées par une interface de test documentée, jamais des données personnelles ou des identifiants réels. Consultez le guide des fixtures et de l’isolement.

Dans ce périmètre, BotBrowser fournit des BrowserContexts isolés pour les tests synthétiques autorisés, chacun séparant cookies, stockage du navigateur et état de session. Il ne s’agit pas d’un sandbox du système d’exploitation et cela ne garantit ni l’invalidation des sessions serveur, ni la suppression des enregistrements distants, ni l’achèvement des tâches en arrière-plan.

TL;DR : résumé

  • Attribuez un propriétaire explicite à chaque donnée synthétique, contexte de navigateur, chemin d’artefact et tâche distante.
  • La fermeture d’un contexte ne nettoie que l’état client ; vérifiez séparément les enregistrements et tâches du serveur via leurs interfaces documentées.
  • Utilisez l’isolement BotBrowser pour comparer un état de navigateur contrôlé, en laissant le nettoyage du service, les secrets et la conservation à leurs propriétaires réels.

Sommaire

Matrice de propriété

RessourceCréateurPropriétaire mutableRésultat observableLimite de nettoyage
Compte synthétiqueservice de testworker du scénariotitre ou accèsAPI de réinitialisation
Contexte et cookiesfixturefixturecontexte viergefermeture dans finally
Référence d’étatdépôtcopie de fixtureroute chargéegarder la référence; supprimer la copie
Répertoire d’artefactsworkerworkerreçu courtsupprimer le chemin local
Tâche distanteapplicationservicestatut documentéannuler ou attendre l’expiration

La fermeture locale ne prouve pas la suppression distante. Chargez une référence en lecture seule et écrivez une copie nommée par worker et tentative. Deux contextes peuvent encore modifier la même donnée; séparez les enregistrements ou sérialisez la mutation prévue.

Fixture d’échec

Une page synthétique sans marqueur de disponibilité vérifie le chemin d’erreur et le nettoyage :

import os from 'node:os';
import path from 'node:path';
import { mkdtemp, rm } from 'node:fs/promises';
import { chromium } from 'playwright';
import { expect } from '@playwright/test';

let dir;
let browser;
let context;
let page;
let failure;
const remember = (label, error) => {
  const current = new Error(`${label}: ${error.message}`, { cause: error });
  failure = failure ? new AggregateError([failure, current], `${failure.message}; ${label} failed`) : current;
};
try {
  dir = await mkdtemp(path.join(os.tmpdir(), 'state-hygiene-'));
  browser = await chromium.launch({ headless: true });
  context = await browser.newContext({ baseURL: 'http://fixture.test' });
  page = await context.newPage();
  await page.route('/fixtures/without-ready-marker', route =>
    route.fulfill({ status: 200, contentType: 'text/html', body: '<main><p>Waiting</p></main>' })
  );
  await page.goto('/fixtures/without-ready-marker');
  await expect(page.getByRole('status')).toHaveText('Ready', { timeout: 250 });
} catch (error) {
  remember('initialisation ou assertion de fixture', error);
} finally {
  if (context) {
    try {
      await context.close();
    } catch (error) {
      remember('fermeture du contexte', error);
    }
  }
  if (dir) {
    try {
      await rm(dir, { recursive: true, force: true });
    } catch (error) {
      remember('nettoyage de l’artefact', error);
    }
  }
  if (browser) {
    try {
      await browser.close();
    } catch (error) {
      remember('fermeture du navigateur', error);
    }
  }
}
if (failure) throw failure;

Tableau de décision

ObservationCatégorieActionNon démontré
Référence absentefixtureéchouer et réparer l’entréedisponibilité du service
Ancien cookie visibleétat navigateurabandonner le contexteinvalidation serveur
Écriture concurrentedonnées de testséparer ou sérialiserdéfaut d’isolation navigateur
Assertion réussie, nettoyage échouéinfrastructuregarder les deux erreurssuppression distante
Nouvelle tentative réussierésultat incertainconsulter le statut admisinnocuité du premier essai

Revoir les transitions

Considérez l’état comme une séquence entre référence, observation et nettoyage. Un changement de compte exige la sortie prévue puis un nouveau contexte; effacer le stockage local ne révoque pas une session distante. Versionnez les références et refusez une copie incomplète plutôt que de la régénérer silencieusement. Pour les versions, le quota et le nettoyage d’IndexedDB, voir Cycle de vie d’IndexedDB : versions, quota et nettoyage.

Protéger secrets et artefacts

Les snapshots peuvent contenir des cookies. Limitez leurs permissions et gardez un reçu bref avec scénario, worker, résultat et nettoyage. N’écrivez ni tokens ni contenu de page. La rétention CI et le répertoire temporaire ont des propriétaires distincts. Voir aussi le guide des transferts de fichiers.

Revoir reprises et parallélisme

Nommez les fichiers par scenario, worker et attempt, sans identifiant personnel. Après un timeout, consultez le statut prévu avant de répéter une mutation. Après une mise à jour, testez contexte vierge, état expiré, changement de compte, sortie parallèle et échec de nettoyage.

La répétabilité vient d’entrées contrôlées, non d’un navigateur partagé durablement. Consignez aussi cleanup.status avec le résultat visible.

Fixez la route, le schéma de fixture, la forme de l’enregistrement synthétique et la configuration utile.

Chaque différence se rattache alors à l’application, à la fixture ou au runner.

Évitez une préparation globale qui crée des comptes, accorde des permissions et laisse des pages ouvertes.

Cette préparation mélange la cause du premier échec et les effets de tests précédents.

La fixture de démarrage indique un état connu chargé ou une connexion documentée terminée.

Elle ne doit pas imprimer le matériel de session utilisé.

La fixture de données indique l’étiquette du scénario et le résultat de réinitialisation.

Elle ne doit pas énumérer des enregistrements pour en trouver un qui passe.

Une entrée absente est un échec de fixture.

Un substitut imprévu rend le résultat non reproductible.

Certains états vivent hors navigateur, comme une boîte de messagerie simulée ou un service de notification.

Chaque dépendance possède son espace synthétique et son reçu.

Le navigateur peut observer une confirmation sans affirmer chaque livraison aval.

Utilisez l’interface de test du service pour les faits qui lui appartiennent.

Fermer une page libère ses listeners et handles.

Fermer un contexte libère l’état géré par ce contexte.

Ces actions ne suppriment pas seules un fichier copié, un objet téléversé ou un token d’un autre appareil.

Effectuez la déconnexion prévue tant que la page est disponible.

Fermez ensuite les ressources navigateur puis le répertoire local du worker. Avec Puppeteer, BrowserContext Puppeteer : propriété des pages et nettoyage décrit les mêmes limites de ressources.

Un échec de nettoyage applicatif peut être distinct de la fermeture du navigateur.

Conservez les deux observations dans le reçu.

Ne recherchez pas des profils, répertoires ou contextes au nom voisin pour élargir le nettoyage.

La récupération peut mettre en quarantaine son répertoire connu quand sa suppression échoue.

Un enregistrement synthétique doit être identifiable sans imiter des données personnelles.

Utilisez un préfixe de scénario, une étiquette d’exécution et des valeurs prévues pour l’assertion.

Pour une limite, modifiez une seule propriété déclarée de l’entrée.

Une réinitialisation restaure une référence connue et ne devine pas une réparation partielle.

Ne réutilisez pas automatiquement une étiquette dont le reçu signale un nettoyage incomplet.

Une assertion décrit ce qu’une personne ou un test autorisé peut voir.

Ne déduisez pas une session distante d’une entrée vide du stockage local.

Ne déduisez pas une tâche asynchrone d’une navigation terminée.

Enregistrez le signal manquant, le statut visible inattendu ou la catégorie d’erreur documentée.

Vérifiez d’abord enregistrement unique, contexte unique et répertoire privé avant de modifier les délais.

Conclusion

Une automatisation de navigateur fiable repose sur des propriétaires explicites et des limites observables. Commencez chaque tentative avec des entrées synthétiques propres au worker, fermez les ressources du navigateur de façon déterministe et rapportez séparément tout nettoyage ou toute conservation côté serveur. BotBrowser rend l’isolement de l’état client reproductible, mais une opération distante non observée ne devient pas une suppression prouvée.

Capacité et limite de BotBrowser

BotBrowser fournit des BrowserContexts isolés avec cookies, stockage et état de session séparés pour des scénarios synthétiques autorisés. Cela permet de vérifier l’absence d’état client hérité; voir la documentation d’isolation multi-compte. BotBrowser ne remplace ni le cycle de vie Playwright/Selenium, ni le nettoyage applicatif, ni l’invalidation serveur, ni la gestion des secrets. Il ne garantit pas l’acceptation d’un cookie expiré, l’annulation d’une tâche ou l’effacement d’un enregistrement fournisseur.

Conservez seulement le scénario, le worker, le résultat visible et le nettoyage. Vérifiez un contexte vierge, un état expiré et cet échec forcé avant intégration.

Sources

#Automatisation Du Navigateur#Données De Test#État#Isolement#Nettoyage

Cet article fait partie du guide : Surfaces d’identité du navigateur : vue de cohérence pratique

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.