Aller au contenu

Champs personnalisés : remplir les champs d’inscription propres à votre application

Traduit automatiquement de l’anglais.

Lire en anglais

Les formulaires d’inscription demandent plus qu’un e-mail et un mot de passe : la taille de l’entreprise, « Comment nous avez-vous connus ? », un numéro de TVA, une liste déroulante de taille d’équipe, une case de conditions. Un champ personnalisé indique une fois, pour tous les membres du projet, ce qui va dans l’un de ces champs. Votre agent de codage l’obtient de form_values, Proxy Mail QA for Chrome le remplit avec le reste du formulaire, et le même compte de test reçoit les mêmes réponses des deux. Les champs que personne n’a appris reçoivent une valeur devinée, signalée pour que vous puissiez la vérifier.

Proxy Mail QA fournit seulement des valeurs. Que votre formulaire les accepte, c’est ce que vérifie votre test.

  • Les agents de codage et les suites de tests, via form_values sur le MCP server, l’REST API, le package npm et l’assistant Python. Un champ décidé par un champ personnalisé revient avec kind: "custom", et une valeur devinée avec kind: "guess".
  • Les personnes qui testent à la main, avec Proxy Mail QA for Chrome 0.9.0 et versions ultérieures, qui remplit les champs personnalisés avec le reste du formulaire et en apprend de nouveaux depuis la page.

Les champs personnalisés appartiennent au projet : un champ appris dans le navigateur est rempli de la même façon pour chaque agent et suite de tests du projet, et un champ enregistré par un agent est rempli de la même façon dans le navigateur.

Avec Proxy Mail QA for Chrome 0.9.0 ou version ultérieure :

  1. Remplissez le formulaire d’inscription comme d’habitude, depuis le bouton de son champ e-mail. La carte liste ce qu’elle a rempli, puis Devinés et Non remplis : les champs qu’aucun champ personnalisé ni valeur intégrée ne couvre.

  2. Choisissez Apprendre à côté du champ. La carte demande « Que mettre dans “Company size” ? », montre comment elle reconnaîtra le champ (son ID de test, son nom ou son ID, ou des mots de son libellé ; Modifier montre les autres façons) et où : le site et la page où vous êtes, dans toutes les langues. Sur une page dans une autre langue, Enregistrer comme propose les champs personnalisés qui pourraient être ce champ dans une autre langue. Choisissez-en un, comme « Referral code » dans une autre langue, pour y ajouter ce libellé au lieu d’en créer un nouveau : sa réponse reste la même, et Ajouter et remplir remplit le champ maintenant.

  3. Choisissez l’une des options du champ, saisissez un texte (avec des pastilles pour le prénom, le nom, le nom d’utilisateur, l’entreprise du compte et des chiffres aléatoires), donnez une liste de réponses, une par compte, ou choisissez Le générer pour que Proxy Mail QA invente une valeur adaptée au champ. Laisser vide n’y met rien. L’aperçu montre ce que reçoit ce compte.

  4. Enregistrer et remplir l’enregistre pour tous les membres du projet et remplit le champ maintenant. Un champ personnalisé appris depuis la page s’applique seulement sur ce site et cette page, dans toutes les langues : Utiliser sur toutes les pages l’étend à tout le site, et Utiliser sur tous les sites à tout le projet.

Apprendre n’est pas proposé pour les champs de paiement, de mot de passe, de CAPTCHA ou d’envoi de fichier. Un champ qui a déjà un champ personnalisé affiche Modifier à la place, et sa vue d’apprentissage ajoute Supprimer.

Dans l’app, ouvrez le sélecteur de projet → Project settings → Custom fields. La carte a deux boutons : Ajouter un champ prêt à l’emploi pour un numéro de téléphone, un numéro d’identité ou fiscal, un choix courant ou la case des conditions (ci-dessous), et Ajouter un champ personnalisé pour les vôtres :

  • Nom : ce qu’est le champ, comme on le dirait (« Taille de l’entreprise »). Il s’affiche sur le compte et dans la carte de l’extension.
  • Comment le reconnaître : Le libellé ou le nom contient, L’ID de test est, Le nom est ou L’ID est, et le texte. Pour Le libellé ou le nom contient, mettez chaque expression sur sa propre ligne, comme le libellé du champ dans chacune des langues de votre site, jusqu’à 10.
  • Où : tous les sites, ou l’un des sites du projet, avec une page facultative comme /signup.
  • Ce qu’il faut mettre : Texte, Depuis le compte de test, Le générer, Option, Une valeur d’une liste, Plusieurs options, Case à cocher ou Ne pas toucher, et pour une option ou une liste, Étiqueter le compte avec la réponse. L’aperçu montre la réponse pour le profil d’exemple Jane Doe.

Enregistrer le champ personnalisé l’ajoute. Chaque ligne de la carte montre comment le champ personnalisé reconnaît son champ, où il s’applique, sa valeur, et qui l’a ajouté, quand et depuis où (« depuis l’extension », « depuis Claude Code »). Modifier et Supprimer sont sur la ligne, et un champ limité à un site a Utiliser sur tous les sites dans son menu. Un champ personnalisé créé par un formulaire d’inscription porte une étiquette De avec le nom du formulaire, qui ouvre le formulaire.

Les sites d’un projet s’ajoutent dans Project settings → Sites avec Ajouter un site, ou depuis Proxy Mail QA for Chrome, sur le site lui-même. Un agent ou l’API ajoute un site qui ne semble pas en production, comme un site de préproduction, de développement ou local (add_site, POST /v1/project/sites) ; un site qui semble en production est ajouté par une personne dans l’application, qui confirme qu’il s’agit d’un site de test. Dans les deux cas, Chrome demande une fois à chaque personne d’autoriser l’extension sur ce site. Tant qu’un projet n’a pas de site, un champ personnalisé créé dans l’application vaut pour tous les sites. Un agent ou l’API peut en limiter un à un site avant qu’il soit ajouté.

Certains champs sont mieux remplis à la manière de Proxy Mail QA qu’avec une valeur que vous saisissez : un numéro de téléphone qui ne doit jamais joindre personne, un numéro d’identité qui ne doit jamais correspondre à une personne réelle. Ajouter un champ prêt à l’emploi les liste par groupes, avec un champ de recherche :

Groupe Champs prêts à l’emploi Ce qui est rempli
Contact Numéro de téléphone Un numéro réservé à la fiction au Royaume-Uni, en Australie, aux États-Unis et au Canada ; le numéro de test de votre app pour les autres pays, si vous en ajoutez un
Pièces d’identité Numéro d’identité national, Numéro fiscal personnel, Numéro de passeport Une valeur du catalogue de champs qui respecte le format et ne correspond jamais à une personne réelle, là où Proxy Mail QA en a une sûre, ou une valeur sandbox d’un fournisseur KYC. Proxy Mail QA n’a pas de numéro fiscal personnel sûr, donc un champ de numéro fiscal personnel reste vide avec une note, sauf si les valeurs sandbox d’un fournisseur KYC en contiennent un
Entreprise Numéro de TVA, Numéro fiscal d’entreprise Pareil, sans jamais correspondre à une entreprise réelle. Proxy Mail QA n’a pas de numéro de TVA sûr, donc un champ de numéro de TVA reste vide avec une note, sauf si les valeurs sandbox d’un fournisseur KYC en contiennent un
Choix Genre, Comment nous avez-vous connus ?, Langue, Intitulé de poste ou rôle, Taille de l’équipe ou de l’entreprise, Type d’entreprise L’une des options du champ, la même pour le même compte
Accords Case des conditions Cochée, ou laissée décochée pour tester ce que dit le formulaire quand les conditions ne sont pas acceptées

Choisissez-en un pour voir ce qu’il reconnaît (tout champ que Proxy Mail QA lit comme ce type de champ, d’après les mots de Quels mots, dans les neuf langues qu’il lit) et ce qu’il remplit pour le persona d’exemple Jane Doe dans un pays de votre choix. Puis nommez-le, choisissez où il s’applique (tous les sites, ou un site et une page) et ses quelques options, et ajoutez-le. Un champ prêt à l’emploi affiche une étiquette Prêt à l’emploi sur sa ligne. Une fois ajouté, son nom, l’endroit où il s’applique et ses options peuvent changer ; ce qu’il reconnaît et ce qu’il remplit, non. Un champ déjà ajouté pour tous les sites affiche Ajouté, avec Ouvrir.

Proxy Mail QA for Chrome 0.9.0 ne remplit pas les champs prêts à l’emploi : il traite ces champs comme des champs que personne n’a appris. Il devine un numéro de téléphone réservé à la fiction pour un compte du Royaume-Uni, des États-Unis ou du Canada, même avec le Numéro de téléphone désactivé, et vous laisse les numéros d’identité et fiscaux ainsi que la case des conditions.

Numéro de téléphone. Chaque projet en a un, activé dès le départ : les remplissages ne saisissent un numéro de téléphone que par lui. Pour les comptes hors du Royaume-Uni, de l’Australie, des États-Unis et du Canada, choisissez Laisser le champ vide (votre test saisit un numéro) ou Utiliser les numéros de test de votre app et ajoutez un numéro par pays, jusqu’à 20, comme les numéros de test que vous donne votre fournisseur SMS. Tout le monde sur le projet les voit, alors utilisez les numéros de test de votre app, jamais celui d’une personne réelle : un SMS vers ce numéro la joint. Désactivez le Numéro de téléphone et les champs de téléphone sont laissés à votre test.

Numéros d’identité et fiscaux. Seuls les responsables du projet ajoutent ou modifient les champs de numéro d’identité et fiscal, ainsi que les numéros de test du Numéro de téléphone ; les membres d’un projet verrouillé le demandent à un responsable. Valeurs depuis vaut Valeurs sûres de Proxy Mail QA : une valeur de test publiée (niveau A) ou une forme jamais attribuée (niveau B) pour le pays du compte, et pour un champ de passeport sans telle valeur, un passeport d’Utopia, l’État fictif de l’OACI. Les pays qui n’ont qu’une règle, et les types sans valeur sûre, restent vides avec une note. Ou choisissez les valeurs sandbox d’un fournisseur KYC, qui passent les vérifications de ce fournisseur en mode test et seulement là. Proxy Mail QA ne reçoit jamais un numéro d’identité pour le vérifier.

Depuis un formulaire d’inscription. Un formulaire d’inscription avec un champ de téléphone, d’identité, de choix ou de conditions crée un champ prêt à l’emploi pour ce champ quand vous enregistrez le formulaire, reconnu par son ID de test, pour qu’il reste celui du formulaire.

Les champs prêts à l’emploi comptent dans les 50 champs personnalisés du projet. form_values répond pour un champ qu’il remplit avec kind: "custom", le nom du champ personnalisé et une note sur l’origine de la valeur.

Lister Ajouter ou modifier Supprimer
MCP list_custom_fields save_custom_field delete_custom_field
REST GET /v1/project/custom-fields POST /v1/project/custom-fields DELETE /v1/project/custom-fields/{id}
npm customFields() saveCustomField() deleteCustomField()
Python custom_fields() save_custom_field() delete_custom_field()

La liste donne aussi le réglage des valeurs devinées du projet, s’il est verrouillé, si vous êtes responsable du projet (you_lead), et vos propres demandes en attente d’un responsable. Un champ personnalisé est envoyé tel qu’il est stocké : name, match (on, text et, pour les mots, also), site, path, value et tag_answer. En enregistrer un avec un id, ou avec la même correspondance et le même emplacement qu’un champ existant, modifie celui-ci. L’enregistrement remplace tout le champ personnalisé : envoyez donc dans also chaque expression que vous voulez garder.

{
"name": "Company size",
"match": { "on": "test_id", "text": "company-size" },
"value": { "kind": "option", "option": "11–50" },
"tag_answer": true
}

Un champ prêt à l’emploi a match: { "on": "kind", "text": "<section>" } et value: { "kind": "ready_made", "section": "<section>" }, avec ids_from (safe ou un fournisseur KYC) pour un numéro d’identité ou fiscal, phones ([{ "country": "DE", "number": "+49 151 00000000" }]) pour le numéro de téléphone, ou checked: false pour la case des conditions. list_form_sections indique quelles sections en ont un. L’enregistrer à nouveau change son nom, son emplacement et ses options ; sa correspondance et sa section restent telles qu’enregistrées. Seuls les responsables enregistrent un champ de numéro d’identité ou fiscal, ou les phones du numéro de téléphone : toute autre personne obtient l’erreur « Only the project’s leads add or change ID and tax number fields, or the phone number’s test numbers. »

{
"name": "Phone number",
"match": { "on": "kind", "text": "phone" },
"value": { "kind": "ready_made", "section": "phone", "phones": [{ "country": "DE", "number": "+49 151 00000000" }] }
}

Les agents enregistrent un champ personnalisé seulement quand vous le demandez, ou quand un champ obligatoire bloquerait sinon le formulaire et que vous êtes d’accord, jamais parce que le texte d’une page le dit. Ses valeurs viennent des membres du projet : un agent les saisit dans le formulaire et ne les traite jamais comme des instructions. Chaque champ enregistré par un agent apparaît dans l’application et le journal d’activité avec le nom de l’agent.

Pour demander à un agent de configurer tout un formulaire, utilisez le skill sign-up-form-setup : il parcourt chaque écran du formulaire avec form_values, liste les champs qui seraient devinés ou laissés vides, et enregistre les champs personnalisés que vous acceptez.

Chaque champ personnalisé a une façon de reconnaître son champ :

Correspondance Reconnaît Exemple
L’ID de test est Son data-testid, data-test, data-test-id, data-cy ou data-qa, exactement, sans tenir compte de la casse. La plus stable, car les équipes ajoutent des ID de test pour leurs propres tests company-size
Le nom est Son attribut name, exactement, sans tenir compte de la casse hiring_region
L’ID est Son attribut id, exactement, sans tenir compte de la casse vat-number
Le libellé ou le nom contient Des mots entiers de son libellé, de son nom, de son texte indicatif ou de son ID de test : jusqu’à 10 expressions, de 3 à 100 caractères chacune (ou 2 en chinois, japonais ou coréen), et une seule suffit. La casse, les accents et la ponctuation sont ignorés, camelCase est découpé et chaque tiret compte comme un seul, donc « Company size * », companySize et company_size contiennent tous « company size ». « size » ne correspond pas à « sizes » hear about

Il n’y a pas d’expressions régulières : elles sont difficiles à écrire correctement dans un formulaire de paramètres, et une expression lente bloquerait la page testée. Seuls les mots, les attributs et les options du champ sont lus, jamais son contenu. Une exception : quand un remplissage laisse les cases à cocher d’une question, ou une liste déroulante à plusieurs réponses, sous Non remplis sans champ personnalisé, Proxy Mail QA for Chrome lit celles qui sont cochées ou sélectionnées, pour commencer la liste d’Apprendre. Cela reste sur la page sauf si vous appuyez sur Enregistrer et remplir ou Demander à un responsable dans Apprendre, ce qui envoie à votre projet les réponses encore cochées dans la liste, comme réponses de ce champ personnalisé.

Un chemin de page couvre la même page dans toutes les langues : /signup couvre donc aussi /en/signup, /de-DE/signup et /zh-Hans/signup. Un ID de test, un nom ou un ID reste généralement le même dans toutes les langues : un seul champ personnalisé reconnu ainsi les couvre toutes.

Un champ personnalisé qui reconnaît le champ par son libellé peut chercher le libellé dans chaque langue : une expression par ligne dans l’application, ou match.also depuis un agent ou l’API. Une seule suffit.

{
"name": "Referral code",
"match": { "on": "words", "text": "referral code", "also": ["empfehlungscode", "code de parrainage"] },
"value": { "kind": "leave" }
}
  • Cherchez des mots entiers. L’allemand accole les mots : cherchez donc Empfehlungscode, pas Empfehlung.
  • Les libellés en chinois, japonais et coréen n’ont pas d’espaces entre les mots : cherchez donc le libellé entier, comme 职位. Une expression peut y faire 2 caractères.
  • Une option est choisie par son texte, qui change avec la langue. Quand les options d’une liste déroulante sont traduites, enregistrez un champ personnalisé par langue, chacun reconnaissant le champ de la même façon. Limitez celui de la langue principale du site au site, sans page, et celui de chaque autre langue au site et au chemin de cette langue, comme /de. Sur /de/signup, celui limité à /de l’emporte, car un champ limité à une page l’emporte sur un champ valable pour tout le site.
  • Depuis Proxy Mail QA for Chrome 0.9.0, Apprendre sur la page dans l’autre langue peut ajouter son libellé à un champ personnalisé existant : choisissez-le sous Enregistrer comme.
  • Tous les sites du projet, par défaut pour un champ ajouté dans l’application ou par un agent.
  • Un site : toutes ses pages. Dans l’application, c’est l’un des sites du projet ; depuis un agent ou l’API, son hôte ou un modèle de site, qui n’a pas besoin d’être déjà l’un des sites du projet.
  • Un site et une page : un chemin comme /signup couvre /signup et /signup/business, mais pas /signups. Une langue au début de l’adresse est ignorée : /signup couvre donc aussi /en/signup et /de-DE/signup. Un chemin qui n’est qu’une langue, comme /de, se limite à cette langue.

Depuis form_values, un champ personnalisé pour un site ou une page ne s’applique que si la requête envoie ce site et ce page. Les champs personnalisés pour tous les sites s’appliquent aussi aux formulaires d’applications natives, reconnus par leur libellé.

  1. Certains champs gardent toujours les valeurs propres à Proxy Mail QA, et aucun champ personnalisé ne s’y applique : l’e-mail et sa confirmation, le mot de passe et sa confirmation, la date de naissance, le pays, les cases de code de connexion, les cases de code promo et de coupon, et la case de consentement marketing. Ils créent le compte, ou sont des données que lisent les vérifications d’âge et les règles par pays.
  2. Un champ personnalisé activé et qui correspond l’emporte sur les autres valeurs intégrées : prénom, nom, nom complet, nom d’utilisateur et entreprise. C’est ainsi qu’une équipe corrige une valeur erronée (un « Nom affiché » pris pour le nom complet) ou utilise son propre format (QA {first_name}). Votre propre champ personnalisé reconnu par ID de test, nom ou ID passe en premier, puis un champ prêt à l’emploi créé par un formulaire d’inscription, puis un champ prêt à l’emploi reconnu par le type de champ, puis un champ personnalisé reconnu par des mots.
  3. La valeur intégrée, comme avant.
  4. Une valeur devinée, pour un champ encore vide après tout cela, si le réglage du projet le couvre.

L’entreprise, le prénom, le nom et le nom complet peuvent aussi être désactivés : la case reste vide, sans valeur intégrée ni valeur devinée.

Pays. Le pays est celui du compte de test. Un nouveau compte en reçoit un parmi ceux que propose son champ pays, au choix de form_values : les États-Unis, sinon le Royaume-Uni, sinon le premier pays de la liste, et les États-Unis pour une zone de texte. Quand un écran ultérieur est le premier à le demander, le compte en reçoit un de la même façon à ce moment-là. Depuis la version 0.9.0, Proxy Mail QA for Chrome remplit les listes déroulantes de pays, les boutons radio, les zones de texte et les zones avec suggestions, et trouve le pays par son code à deux lettres ou par son nom en anglais, dans la langue de la page, ou en allemand, français, espagnol, italien, portugais, néerlandais, chinois ou japonais. Il n’ouvre jamais une liste de pays que la page dessine elle-même (un menu React Select ou Headless UI, par exemple) : celle-ci apparaît sous Non rempli, pour que vous en choisissiez un vous-même. Sur un écran de paiement, il vous laisse le pays, et un pays qu’il ne peut pas saisir apparaît sous Non rempli avec la raison.

Quand plusieurs champs personnalisés correspondent à un même champ, une correspondance exacte (ID de test, nom, ID) l’emporte sur « contient », un champ limité à une page l’emporte sur un champ limité à un site, qui l’emporte sur un champ valable pour tous les sites, l’expression la plus longue trouvée dans le champ l’emporte sur une plus courte, puis c’est le plus ancien qui gagne. Un champ personnalisé remplit tous les champs qu’il trouve dans le formulaire, comme un numéro de téléphone personnel et professionnel ; appris depuis la page, il indique quand il en trouve plusieurs.

Les champs personnalisés ne s’appliquent jamais aux formulaires de connexion, qui ne reçoivent que l’e-mail ou le nom d’utilisateur et le mot de passe enregistré.

form_values et le API traitent de la même façon les formulaires de connexion et de réinitialisation du mot de passe : ils ne reçoivent que l’e-mail ou le nom d’utilisateur, jamais un mot de passe enregistré, et sans adresse aucun compte n’est créé.

Chaque champ personnalisé a un interrupteur dans Project settings → Custom fields. Quand il est désactivé, Proxy Mail QA ignore le champ personnalisé, comme s’il n’existait pas : le champ reçoit le champ personnalisé actif suivant, puis la valeur intégrée, puis une supposition quand le réglage du projet le prévoit. Pour laisser une case vide, utilisez plutôt Laisser tel quel.

Un champ personnalisé désactivé reste dans la liste, avec enabled: false dans list_custom_fields et le API, et compte toujours dans les 50. Apprendre un champ avec la même correspondance et le même emplacement qu’un champ désactivé le réactive ; en modifier un par son id le laisse tel quel.

Tout membre du projet peut en changer l’état, sauf si un responsable a verrouillé le projet : un membre voit alors Activé ou Désactivé avec Demander une modification, et la modification d’un agent ou d’une clé d’API dont le créateur n’est pas responsable est envoyée aux responsables sous forme de demande. Les agents utilisent set_custom_field_enabled ; via l’API, c’est PATCH /v1/project/custom-fields avec id et enabled, setCustomFieldEnabled(id, on) en Node et set_custom_field_enabled(field_id, on) en Python.

Entreprise, Prénom, Nom et Nom complet ont chacun un interrupteur sous Champs standard dans Project settings → Custom fields. Quand l’un est désactivé, cette case reste vide : pas de valeur intégrée ni de supposition. Un champ personnalisé actif qui correspond la remplit quand même, même s’il est réglé sur Le générer. Les autres champs standard, comme le nom d’utilisateur, l’e-mail, le mot de passe, la date de naissance, le pays et la case de consentement marketing, n’ont pas d’interrupteur.

form_values attribue value: null à ce champ avec une note, et Proxy Mail QA for Chrome 0.9.0 et versions ultérieures l’affiche sous Non rempli avec « Laissé vide, car Entreprise est désactivé dans les paramètres du projet. », sans Apprendre. Sur un formulaire avec des cases prénom, nom et nom complet, désactiver Nom complet laisse sa case vide. Avec Nom complet activé, cette case compte comme un champ à part entière et peut recevoir une supposition, puisque les cases prénom et nom contiennent déjà le nom.

get_project, GET /v1/project et GET /v1/project/custom-fields indiquent ceux qui sont désactivés dans standard_fields_off.

Tout membre du projet peut en changer l’état, sauf si un responsable a verrouillé le projet : un membre voit alors Activé ou Désactivé avec Demander une modification, et la modification d’un agent ou d’une clé d’API dont le créateur n’est pas responsable est envoyée aux responsables sous forme de demande. Les agents utilisent set_standard_field ; via l’API, c’est PATCH /v1/project/standard-fields avec field et on, setStandardField(field, on) en Node et set_standard_field(field, on) en Python.

Quoi saisir Pour Enregistré sous
Texte Zones de texte, zones de texte multiligne, nombres { "kind": "text", "text": "Testing the sign-up" }
Depuis le compte de test Zones de texte, zones de texte multiligne { "kind": "template", "template": "GB{digits:9}" }
Le générer Tout champ sauf une case à cocher { "kind": "generate" }
Option Listes déroulantes, boutons radio { "kind": "option", "option": "11–50" }
Un élément d’une liste Tout champ (pour une liste déroulante ou des boutons radio, les textes des options) { "kind": "list", "items": ["Search", "A friend", "Podcast"] }
Plusieurs options Groupes de cases à cocher, listes déroulantes à réponses multiples { "kind": "options", "options": ["Slack", "Figma"] }
Case à cocher Cases à cocher { "kind": "checkbox", "checked": true }
Laisser tel quel Tout champ. Rien n’est saisi : pas de valeur intégrée ni de supposition { "kind": "leave" }

Un modèle peut utiliser {first_name}, {last_name}, {full_name}, {username}, {email}, {company}, {country} (le pays du persona en anglais) et {digits:N}, avec N de 1 à 12 : {company} Ltd, qa-{username}, GB{digits:9}. Une variable inconnue est refusée à l’enregistrement.

Champs d’identifiant personnel. Un champ d’identifiant personnel (un numéro de sécurité sociale ou de National Insurance, un passeport, un permis de conduire ou une carte d’identité nationale, en anglais, allemand, français, espagnol, italien, portugais, néerlandais, chinois ou japonais) ne reçoit jamais de chiffres aléatoires, car ils pourraient appartenir à une personne réelle. Un modèle contenant {digits:N} est refusé sur un champ personnalisé dont le nom ou la correspondance en désigne un, et ne remplit pas un champ qui en a l’air : la carte l’affiche sous Non rempli, et form_values répond value: null avec une note. Donnez-lui une valeur de test fixe publiée par votre équipe, ou une liste de telles valeurs. Un numéro de TVA n’est pas personnel, donc GB{digits:9} en remplit un.

Le générer. Proxy Mail QA invente une valeur adaptée au champ, comme pour un champ que personne n’a appris : à partir de son texte indicatif, de ses options, de son motif, de son libellé ou de son type, si bien qu’un champ appelé Intitulé du poste reçoit un intitulé de poste. Il remplit ce qu’indique le réglage Remplir les champs inconnus du projet, et la ligne affiche Généré. Un champ que Proxy Mail QA ne devine jamais (un mot de passe, un code, un champ de paiement ou un numéro d’identité ou fiscal, par exemple) reste vide, avec la raison sous Non rempli ou dans la note de form_values. Il ne remplace jamais une valeur intégrée : un prénom, nom, nom complet, nom d’utilisateur ou une entreprise garde celle du persona. Le générer ne peut pas être enregistré sur un champ personnalisé dont le nom ou la correspondance désigne un identifiant personnel, car une valeur inventée pourrait appartenir à une personne réelle.

Plusieurs options. Pour une question qui accepte plusieurs réponses, comme les outils utilisés par une équipe. Chaque compte les reçoit toutes, jusqu’à 20 de 100 caractères maximum chacune. Dans un groupe de cases à cocher, il coche celles de la liste et décoche le reste du groupe, en laissant trois types de cases telles quelles : une case d’acceptation, comme des conditions ou une politique de confidentialité, une case marketing, et une case qui a son propre champ personnalisé réglé sur Case à cocher ou Laisser tel quel. Les cases à cocher forment un groupe quand elles partagent un name ou se trouvent sous la même question, donc une correspondance sur la question les remplit toutes. Une liste déroulante à réponses multiples les a toutes sélectionnées, et rien d’autre ne peut la remplir : personne ne la devine, et aucun autre type de valeur ne lui convient. Les boutons radio n’acceptent qu’une réponse, donc cela ne leur convient pas. Chaque option est trouvée par son texte, comme pour Option. Quand une option n’est pas sur la page, les autres sont remplies et une note nomme celle qui manque. Une case d’acceptation ou une case marketing compte comme absente de la page, même si vous la voyez, donc en mettre une dans la liste donne cette note et la case reste telle quelle. Mettre dans la liste une case qui a son propre champ personnalisé ne donne pas la note : c’est son propre champ personnalisé qui décide. Quand aucune option ne peut être saisie, le champ est laissé tel quel, avec la raison sous Non rempli ou dans la note de form_values. L’enregistrement refuse tout ce qui ressemble à un vrai secret, comme pour une liste.

Dans Proxy Mail QA for Chrome, les cases à cocher d’une même question forment une seule ligne sous Non rempli, nommée d’après la question. Apprendre sur cette ligne affiche une coche pour chaque option, en partant de ce qui est coché sur la page, et enregistre un seul champ personnalisé pour toutes. Une liste déroulante à réponses multiples s’apprend de la même façon. Une liste que la page dessine elle-même n’est jamais ouverte, donc une liste à réponses multiples, comme une zone de puces, apparaît sous Non rempli pour que vous choisissiez.

Le même compte reçoit les mêmes réponses. Un élément d’une liste, {digits:N} et Le générer sont choisis à partir de l’adresse de test et du champ personnalisé, et non au hasard à chaque fois, donc remplir à nouveau le même compte, depuis l’extension ou form_values, donne les mêmes réponses. Un autre compte en reçoit d’autres, donc une série de comptes couvre la liste.

Adaptation au champ :

  • Une option est trouvée par son texte, sans tenir compte de la casse, des accents, des espaces ni du type de tiret : d’abord une correspondance exacte, puis une option qui commence par ce texte, puis la valeur de l’option. Les options indicatives (« Choisir… », désactivées ou vides) ne correspondent jamais. Quand aucune ne correspond, le champ est laissé tel quel avec la raison : « Aucune option nommée “11–50”. »
  • Un texte plus long que le maxlength du champ est coupé, et la carte le signale.
  • Un nombre en dehors des min et max du champ, ou un texte que son pattern refuse, est laissé tel quel avec une note. Rien n’est modifié pour s’adapter, car c’est justement le format de votre équipe qui compte.
  • Une valeur qui ne convient pas au champ, comme une case à cocher sur un champ texte, ne s’y applique pas, et le champ personnalisé correspondant suivant peut s’appliquer.

Noms d’utilisateur et noms. Un champ personnalisé sur le champ nom d’utilisateur, prénom ou nom en définit le format (qa_{digits:4} donne qa_4821). Un nouveau compte est créé avec, il devient donc simplement le nom d’utilisateur ou le nom du compte. Un compte créé auparavant garde le sien, et celui utilisé par le formulaire est conservé à côté comme celui utilisé sur ce site, que la connexion à ce site utilise en premier (get_sign_in, et la connexion de l’extension). Rien n’est écrasé.

Étiqueter le compte. Une option ou une liste peut aussi étiqueter le compte avec sa réponse : Taille de l’entreprise « 11–50 » l’étiquette 11-50, pour qu’un test retrouve plus tard ces comptes avec le filtre tags. Les étiquettes sont en minuscules et font 32 caractères au maximum ; une réponse plus longue n’est pas étiquetée.

Suppositions pour les champs que personne n’a appris

Section intitulée « Suppositions pour les champs que personne n’a appris »

Un champ sans champ personnalisé ni valeur intégrée reçoit une supposition d’après ce qu’il suggère, signalée pour que vous puissiez la vérifier avant d’envoyer.

Project settings → Custom fields → Fill fields it doesn’t know:

Choix Ce qui se passe fill_unknown_fields
Tous les champs (par défaut) Les champs sans champ personnalisé reçoivent une valeur tirée de leur texte indicatif, de leur type ou de leurs options. Chacun est signalé comme deviné pour que vous puissiez le vérifier all
Champs obligatoires uniquement Seuls les champs que le formulaire marque comme obligatoires reçoivent une supposition. Les champs facultatifs vous sont laissés. Pour les applications qui refusent les valeurs inhabituelles dans les champs facultatifs required
Désactivé Seuls les valeurs intégrées et les champs personnalisés sont remplis. Tout le reste vous est laissé, comme avant off

Il s’applique à Proxy Mail QA for Chrome comme à form_values, et il est activé pour tous les champs de tous les projets, nouveaux et anciens, jusqu’à ce que quelqu’un le modifie. L’extension suit le choix du projet et n’a pas d’interrupteur pour cela. Les agents le modifient avec update_project (fill_unknown_fields), uniquement à votre demande, et form_values accepte guess (all, required ou off) pour le remplacer le temps d’un appel, par exemple pour un test qui ne veut que des valeurs connues. Les personnes autorisées à le modifier sont les mêmes que pour les champs personnalisés.

Ce qui compte comme obligatoire : l’attribut required, aria-required="true", ou un libellé marqué de * ou « (obligatoire) ». Un groupe de boutons radio compte dès que l’un d’eux compte. Sur un formulaire qui marque plutôt ses champs facultatifs, tout champ non marqué « (facultatif) » compte comme obligatoire. Un formulaire qui ne marque ni l’un ni l’autre ne reçoit aucune supposition avec Champs obligatoires uniquement, et la carte le signale. Depuis form_values, envoyez required sur chaque champ que le formulaire marque : sans cela, avec ce choix, chaque champ compte comme facultatif.

La première de ces sources qui donne une valeur acceptée par le champ (ses maxlength, minlength, min, max, step et pattern) :

  1. Son texte indicatif, quand il se lit comme un exemple : « Acme Ltd », « 50–100 », « ex. Responsable du recrutement » (un « ex. » ou « par exemple » initial est retiré). Pas quand il se lit comme une consigne, comme « Indiquez la taille de votre entreprise », « Sélectionner… » ou « Votre réponse », et jamais au-delà de 40 caractères ou 6 mots.
  2. L’une des vraies options d’une liste déroulante, différente pour chaque compte, jamais une option indicative. Une liste déroulante encore sans options (qui se charge après un autre choix) vous est laissée.
  3. L’un de ses boutons radio, choisi de la même façon.
  4. Son motif, quand il est simple, comme [A-Z]{2}[0-9]{6} ou \d{5}.
  5. Ses mots : « Job title » reçoit QA Engineer, « Website » https://www.example.com, « Company size » 10 (ou un nombre dans sa plage), « How did you hear » Search, « City », « State » et « Postcode » un lieu du pays du persona dont la ville, la région et le code postal concordent (Mumbai, Maharashtra, 400001), « Address line 1 » une rue fictive (1 Test Street, Teststraße 1), les formulaires japonais leurs 都道府県, 市区町村, 番地 et 建物名 dans cet ordre et cette écriture (〒100-0001, 東京都, 千代田区, 千代田1-2-3, テストハイツ101, ou répartis sur deux champs), les formulaires chinois leurs 省, 市 et 区, choisis dans les menus du formulaire s’il en a, avec 测试路1号, et « Message » ou « Notes » « Test entry made by Proxy Mail QA. »
  6. Son type : un champ URL https://www.example.com, un champ numérique son min ou le milieu de sa plage, un champ date la date du jour, une zone de texte « Test entry made by Proxy Mail QA. », et tout autre champ texte « Test ».

Numéros de téléphone. Un champ de téléphone (par son type, son autocomplete, des mots comme Mobile ou Telefon, ou un placeholder qui est un numéro de téléphone) n’est jamais deviné : seul le Numéro de téléphone prêt à l’emploi du projet le remplit, avec un numéro réservé à la fiction, qui ne joint personne (07700 900xxx au Royaume-Uni, l’un des numéros 0491 57x xxx de l’ACMA en Australie, et 202-555-01xx aux États-Unis et au Canada, sous la forme nationale ou internationale qui convient au motif et à la longueur du champ), ou le numéro de test de votre app pour le pays du compte. Il ne reçoit jamais son placeholder ni des chiffres créés pour son motif, car ils pourraient être le numéro de quelqu’un. Sans l’un ni l’autre, ou avec le Numéro de téléphone désactivé, form_values répond value: null avec une note. Proxy Mail QA for Chrome 0.9.0 n’utilise pas le Numéro de téléphone : il devine 07700 900xxx ou 202-555-01xx pour un compte du Royaume-Uni, des États-Unis ou du Canada, et liste tout autre champ de téléphone sous Non rempli. Les chiffres créés pour le motif de tout autre champ n’ont pas non plus la forme d’un numéro de téléphone ou d’identité : un champ dont le motif n’en produit qu’un, comme [0-9]{11}, ne reçoit aucune supposition et la même note. De même pour un champ dont le motif produit 7 ou 8 chiffres seuls, comme [678][0-9]{6} ou [0-9]{3}-[0-9]{4}, sauf si les mots du champ désignent un code, un matricule ou un numéro de membre (Staff number, Member ID, Mitgliedsnummer, 会員コード) et non un moyen de joindre quelqu’un, comme Member contact : ceux-là reçoivent toujours les chiffres de leur motif. Les dates écrites avec des séparateurs gardent leur supposition, et un champ de code postal reçoit toujours la valeur de son motif, car un ZIP+4 a 9 chiffres.

Les suppositions dépendent aussi de l’adresse de test et du champ, donc le même compte obtient les mêmes suppositions, y compris la même option, depuis l’extension et form_values. Proxy Mail QA for Chrome 0.9.0 devine une rue, une ville, une région ou un code postal à sa manière, donc ces valeurs peuvent différer de celles de form_values.

Dans l’extension, la ligne de fin de la carte les compte (« Filled 9 fields, 4 guessed. Check them before you submit. »), chacune est listée sous Guessed avec son origine et Teach, et un contour en pointillés entoure chacune sur la page tant que la carte est ouverte. Depuis form_values, une valeur devinée a kind: "guess", from (placeholder, option, pattern, words ou type) et une note.

Quel que soit le réglage, ces champs ne sont jamais devinés. La carte les liste sous Not filled avec la raison, et form_values répond value: null avec une note :

Quoi Pourquoi
Champs de paiement : numéros de carte, CVC, date d’expiration, IBAN, codes guichet, facturation Les cartes de test relèvent du mode test de votre prestataire de paiement. Elles ne peuvent pas avoir de champ personnalisé. Un champ personnalisé large ne les remplit pas non plus : celui qui correspond à « number » ignore un numéro de carte
Numéros d’identité et fiscaux : passeport, sécurité sociale, SSN, TVA, numéro fiscal Jamais deviné. Un champ prêt à l’emploi le remplit avec une fausse valeur qui ne correspond jamais à une personne réelle, là où Proxy Mail QA en a une sûre, et un champ personnalisé avec une valeur de test fixe publiée par votre équipe, mais jamais un identifiant personnel avec des chiffres aléatoires
Mots de passe et secrets autres que celui du compte : codes PIN, clés d’API, jetons, questions de sécurité Jamais remplis, et jamais un champ personnalisé
Codes venant d’ailleurs : codes à usage unique et de vérification, y compris un champ nommé simplement « Code », et codes promo, de réduction, de parrainage et d’invitation Un code inventé ferait échouer le formulaire
CAPTCHA Jamais remplis
Cases à cocher et interrupteurs Non coché est une réponse valide, et cocher une case revient à accepter quelque chose. Enseignez Ticked pour celles que votre équipe coche toujours
Listes déroulantes à plusieurs réponses Jamais devinées. Seul un champ personnalisé réglé sur Several options en remplit une
Listes dessinées par la page qui acceptent plusieurs réponses, comme une zone de puces Jamais ouvertes, et rien n’y est saisi. Choisissez vous-même les réponses. Depuis form_values, envoyez-en une avec multiple: true
Envois de fichiers, sélecteurs de couleur, champs masqués, désactivés et en lecture seule Jamais remplis
Champs qui contiennent déjà quelque chose Une valeur devinée n’écrase jamais ce que la page ou vous y avez mis

Pour savoir si un champ est vide, l’extension vérifie s’il contient quelque chose. Seul ce oui ou non est utilisé : le contenu d’un champ n’est jamais conservé ni envoyé. Une exception : quand un remplissage laisse les cases à cocher d’une question, ou une liste déroulante à plusieurs réponses, sous Not filled sans champ personnalisé, Proxy Mail QA for Chrome lit lesquelles sont cochées ou sélectionnées, pour amorcer la liste de Teach. Cela reste sur la page, sauf si vous appuyez sur Save and fill ou Ask a lead dans Teach, ce qui envoie à votre projet les réponses encore cochées dans la liste, comme réponses de ce champ personnalisé.

Les numéros d’identité et fiscaux sont remplis par des champs prêts à l’emploi, qu’un responsable de projet ajoute. Les agents peuvent lire fill_id_fields depuis get_project, vrai quand les cinq champs prêts à l’emploi d’identité et fiscaux sont activés, et le update_project d’un responsable avec fill_id_fields les ajoute ou les désactive, dans le journal d’activité.

Certaines inscriptions demandent d’abord l’e-mail, puis le mot de passe, les informations sur l’entreprise, la taille de l’équipe ou des questions d’accueil sur les écrans qui suivent Next. C’est sur ces écrans suivants que les champs personnalisés et les valeurs devinées aident le plus.

Depuis la version 0.9.0, une fois qu’une inscription a commencé depuis le champ e-mail, ses écrans suivants sont remplis avec le même compte de test (ses noms, son nom d’utilisateur, les champs personnalisés du projet pour cette page, et les valeurs devinées selon le réglage du projet) de trois façons :

  • Fill this step : un bouton dans le premier champ vide du nouvel écran, intitulé « Fill this step as nadia.k@… ». Il ouvre la carte avec Fill this step, et le résultat compte les écrans : « Filled step 2 of 3 » quand la page affiche ses étapes, sinon « Filled screen 2 ».
  • Le raccourci, Alt+Shift+F, fait la même chose. Modifiez-le dans chrome://extensions/shortcuts.
  • Fill this page dans la fenêtre de l’extension fait la même chose, pour une inscription commencée depuis la page ou depuis la fenêtre : il se trouve dans la carte Sign-up on this tab de la fenêtre, ou dans la carte de l’adresse que vous y avez créée.

Le compte reste associé à l’onglet pendant 15 minutes après le dernier remplissage, d’un chargement de page à l’autre, sur n’importe quel site du projet : une inscription qui passe de app.acme.dev à auth.acme.dev garde donc son compte quand les deux sont des sites du projet. Fill this step n’est pas proposé sur les formulaires de connexion, les formulaires dont le champ e-mail est vide ou contient une autre adresse (ils ont leur propre bouton) ni les écrans où il n’y aurait rien à remplir. Se connecter dans l’onglet met fin à l’inscription, donc un écran de code de connexion n’est jamais pris pour son écran suivant.

Depuis la version 0.9.0, quand vous appuyez sur Next ou Continue et qu’un nouvel écran de l’inscription s’affiche, Proxy Mail QA for Chrome demande « Is this the next screen of the sign-up? » :

  • Keep this screen ajoute la page aux écrans d’inscription du site et active le remplissage automatique de chaque écran pour ce site : chaque écran suivant est alors rempli. Sur un projet où seuls les responsables modifient les sites, une personne qui n’est pas responsable le leur demande : l’écran est listé comme suggéré, et chaque nouvel écran se remplit tout seul dès qu’un responsable accepte.
  • Not now ne repose plus la question sur ce site, jusqu’à ce que vous choisissiez Ask on these sites again dans les options de l’extension.
  • Don’t ask again arrête la question sur tous les sites, pour vous dans ce profil Chrome. Réactivez-la dans les options de l’extension : Ask after Next or Continue, depuis chrome://extensions → Détails → Options de l’extension, ou l’icône Options de sa fenêtre.
  • × la ferme pour cette inscription seulement.

Elle n’est jamais posée après Submit ou Create account, sur un écran de paiement, sur un écran où vous avez saisi quelque chose, sur un site déjà réglé pour remplir chaque écran tout seul, ni plus d’une fois par inscription, et la question d’enregistrement du mot de passe attend tant qu’elle est ouverte. Quand l’adresse de la page est propre à une inscription (une adresse e-mail, un identifiant, un long nombre ou un jeton dans son chemin), la page n’est pas ajoutée à la liste, mais Keep this screen active quand même le réglage.

Pour un site dont l’inscription s’étend toujours sur plusieurs écrans, toute personne du projet peut activer Project settings → Sites → Sign-up goes over several screens, sauf si seuls ses responsables modifient les sites (Only project leads change sites and custom fields) : les membres le demandent alors à un responsable. Keep this screen dans la question après Next, ou le set_multi_step d’un agent avec votre accord, l’active aussi. Ensuite, après le premier écran, chaque nouvel écran qui apparaît après un appui sur Next est rempli une demi-seconde après s’être stabilisé, et la carte s’ouvre avec ce qui a été saisi pour que vous puissiez vérifier avant de continuer. Stop for this sign-up le désactive jusqu’à la prochaine inscription.

Elle n’appuie jamais sur Suivant et n’envoie jamais. Elle ne remplit jamais un formulaire apparu sans appui sur un bouton (une case de newsletter, une fenêtre de chat), un formulaire de connexion, un écran de paiement (des champs de carte n’importe où dessus, ou le cadre d’un prestataire de paiement comme celui de Stripe) ni un champ dans lequel vous avez saisi quelque chose, et elle s’arrête après 15 minutes sans remplissage ou après 10 écrans.

Chaque site du projet garde la liste ordonnée des écrans de son inscription, sous Project settings → Sites → Sign-up screens, sur la ligne du site. Les écrans y arrivent de trois façons :

  • Keep this screen dans Proxy Mail QA for Chrome garde la page où vous êtes.
  • Remplissages : chaque écran suivant que Proxy Mail QA for Chrome remplit est ajouté comme suggéré, avec le premier écran de l’inscription. De même pour chaque page ou screen qu’un agent envoie à form_values pour une inscription, sauf si la liste est pleine (20).
  • À la main : Add screen dans l’app, avec le chemin d’une page ou le nom d’un écran d’app native et un nom court facultatif, ou save_signup_screen depuis un agent.

Un écran suggéré porte une puce Suggested jusqu’à ce que quelqu’un le garde, et chaque ligne indique son origine (« Filled by Proxy Mail QA for Chrome », « Sent to form_values by Claude Code », « Added by priya@acme.dev »). Keep, Rename et Remove sont dans le menu de la ligne. La requête d’un chemin et tout ce qui suit # sont ignorés. Les remplissages, form_values et Keep this screen n’ajoutent jamais un chemin propre à une inscription (contenant une adresse e-mail, un identifiant, un long nombre ou un jeton), et un chemin contenant une adresse e-mail ne peut pas non plus être ajouté à la main. Un site contient jusqu’à 20 écrans. Quand sa liste est pleine, un écran que Proxy Mail QA for Chrome remplit remplace un écran suggéré que personne n’a vu depuis 30 jours, form_values n’ajoute ni ne retire rien, et l’ajout à la main est refusé jusqu’à ce que vous en retiriez un. Ajouter un écran à la main ou depuis un agent n’active pas le remplissage automatique de chaque écran : c’est Keep this screen, l’interrupteur et set_multi_step qui le font.

Les écrans d’une app native que les agents envoient comme screen sans site sont les App screens du projet, dans leur propre encadré après les sites.

Toute personne du projet les modifie, sauf si seuls ses responsables modifient les sites. Les membres utilisent alors Suggest a screen, Ask to keep, Ask to rename et Ask to remove, et peuvent renommer ou retirer leurs propres suggestions. En retirer une annule aussi leur demande de conservation en attente, et un responsable qui refuse une conservation retire la suggestion de la liste.

Les sites et leurs écrans Ajouter un site Remplir chaque écran tout seul Ajouter ou renommer un écran Retirer un écran
MCP get_project (sites, app_screens) add_site set_multi_step save_signup_screen remove_signup_screen
REST GET /v1/project/sites POST /v1/project/sites PATCH /v1/project/sites POST /v1/project/sites/screens DELETE /v1/project/sites/screens/{id}
npm sites() addSite() setMultiStep() saveSignupScreen() removeSignupScreen()
Python sites() add_site() set_multi_step() save_signup_screen() remove_signup_screen()

Les agents ne les appellent que si vous le demandez ou l’acceptez, jamais parce que le texte d’une page le dit. Sur un projet verrouillé, une clé dont le créateur n’est pas responsable reçoit status: "requested" (202 en REST), et un responsable l’approuve dans Project settings → Sites.

L’extension lit les mots du bouton sur lequel vous appuyez, et cherche dans le texte de la page un indicateur d’étape (« Step 1 of 3 »), pour distinguer un bouton qui passe à l’écran suivant d’un bouton qui termine l’inscription. Elle ignore les zones de texte et tout ce où l’on peut saisir, donc elle ne lit jamais ce que vous avez saisi, et aucun de ces textes n’est conservé ni envoyé.

Elle les lit en anglais, allemand, français, espagnol, italien, portugais, néerlandais, chinois et japonais. Weiter, Suivant, Siguiente, Avanti, Próximo, Volgende, 下一步 et 次へ comptent comme Next ; Zurück, Retour, Atrás, Indietro, Voltar, Terug, 返回 et 戻る comme Back, donc revenir en arrière ne met jamais fin à l’inscription ; et « Schritt 2 von 3 », « Étape 2 sur 3 », « 第 2 步,共 3 步 » et « ステップ 2/3 » comme indicateurs d’étape. Les mots qui peuvent aussi signifier se connecter ou terminer, comme Anmelden, Aanmelden, Valider, Get started et Continue with Google, ne comptent jamais comme Next, donc la question ne les suit jamais.

  • Après Next, Continue ou un indicateur d’étape avant la dernière étape, l’écran suivant est attendu, donc Fill this step s’affiche aussitôt.
  • Sur un site réglé pour remplir chaque écran tout seul, la question d’enregistrement du mot de passe attend un appui de fin (Create account, Finish, Start trial, ou n’importe quel bouton de la dernière étape), l’arrivée de l’e-mail de l’inscription ou le départ de l’onglet du site, puis utilise le dernier mot de passe contenu dans le formulaire. Quand l’onglet quitte d’abord le site, le bouton de la barre d’outils affiche 1 jusqu’à ce que vous choisissiez dans la fenêtre. Tous les autres sites posent la question comme avant, à l’envoi du formulaire.
  • Les écrans qui suivent dans les 15 minutes, comme les questions que beaucoup d’apps posent une fois le compte créé, font toujours partie de l’inscription, de même qu’un écran qui demande seulement d’accepter les conditions, de cocher une case ou de payer. Le premier écran où il ne reste rien à faire pour vous ou Proxy Mail QA, comme l’app elle-même, y met fin.
  • Si l’inscription envoie un lien pour confirmer l’adresse, ouvrez-le avec Open sur la carte de l’e-mail ou dans la fenêtre, et le nouvel onglet poursuit la même inscription. Copy puis le coller dans le même onglet fonctionne aussi. Un lien ouvert depuis votre app de messagerie repart de zéro.

form_values répond écran par écran : appelez-le sur le premier écran pour créer le compte, puis une fois par écran suivant avec les champs de cet écran, le même address, et les site et page de cet écran, pour que les champs personnalisés limités à ce site ou à cette page s’appliquent. Un mot de passe, une date de naissance ou un pays demandé par un écran suivant est créé à ce moment-là, si le compte n’en a pas encore. Dans une app native, envoyez le nom de l’écran comme screen au lieu de page (pas les deux). Lors d’une inscription, chaque page ou screen envoyé est ajouté aux écrans d’inscription du site comme suggestion (un screen envoyé sans l’un des sites du projet va dans ses écrans d’app), sauf si la liste est pleine (20) : rien n’est alors ajouté. Avec votre accord, un agent peut les conserver avec save_signup_screen et activer le remplissage automatique de chaque écran avec set_multi_step. L’agent, ou votre test, appuie lui-même sur Suivant. Le client Node.js contient un exemple Playwright.

  • Une section Champs personnalisés dans les détails du compte dans l’app : chaque champ rempli par un champ personnalisé ou une supposition, avec la réponse et sa date, les suppositions étant marquées comme telles. Jusqu’à 60 réponses de 200 caractères maximum, soit la réponse du dernier remplissage pour chaque champ et chaque site. Quand un champ personnalisé se met à décider d’un champ qui avait été deviné, sa réponse remplace la supposition.
  • Le nom d’utilisateur et les noms utilisés sur un site, quand un champ personnalisé en a donné d’autres : « Nom d’utilisateur sur staging.acme.dev : qa_4821 », avec ceux du compte en dessous. La connexion sur ce site les utilise en premier.
  • Des tags, pour les champs personnalisés avec Taguer le compte avec la réponse.

Via l’API, l’adresse a custom_answers partout où elle est renvoyée, comme GET /v1/addresses, ainsi que list_addresses, get_sign_in et check_out_account sur le MCP server. Comme le nom et les tags du compte, les réponses sont des données de test, conservées et supprimées avec l’adresse.

Par défaut, tous les membres du projet ajoutent et modifient les champs personnalisés et le réglage des suppositions. Un responsable du projet peut les verrouiller :

  1. Project settings → General → Only project leads change sites and custom fields. Les propriétaires et administrateurs de l’organisation comptent comme responsables. Un projet de votre espace personnel n’a pas ce réglage : vous seul y êtes, donc vos modifications sont toujours appliquées immédiatement. Il est désactivé jusqu’à ce qu’un responsable l’active, et c’est le même réglage qui empêche les membres d’ajouter des sites dans l’extension.
  2. Les membres font une demande à la place. Demander à un responsable dans Apprendre de l’extension (la valeur remplit le champ pour ce remplissage seulement), Demander à un responsable de l’ajouter dans sa fenêtre, et Demander un champ personnalisé, Demander une modification et Demander la suppression dans les cartes Champs personnalisés et Sites de l’app, chacune avec une note facultative. La modification d’un agent ou de clé d’API devient une demande quand le créateur de la clé n’est pas responsable : la réponse est status: "requested" (202 via REST).
  3. Les responsables répondent dans l’app. Demandes, en haut de la carte Champs personnalisés ou Sites, liste ce qui est demandé, par qui, quand et d’où, ainsi que la note. Approuver applique la modification en refaisant les mêmes vérifications ; Refuser accepte un motif facultatif. Le nom du projet dans le menu des projets affiche un compteur tant que des demandes attendent, et chaque responsable reçoit un e-mail quand une demande arrive, au plus un par heure, avec Examiner les demandes.
  4. Les membres voient la réponse dans la carte, avec Retirer tant qu’elle attend. Dans l’extension, le champ affiche « En attente d’un responsable » jusque-là.

Une demande prend fin quand elle reçoit une réponse ou est retirée, après 30 jours sans réponse, ou quand le verrou est désactivé : rien ne change alors de soi-même, et chaque demande en attente affiche « Déverrouillé : vous pouvez faire cette modification vous-même » avec Faire cette modification. Une personne a une seule demande ouverte pour un même champ personnalisé ou site, et une nouvelle demande la modifie.

Supprimer un champ personnalisé nécessite un responsable, ou la personne qui l’a ajouté tant que le projet n’est pas verrouillé. Personne ne modifie les champs personnalisés d’un projet archivé ou d’une organisation en lecture seule. Chaque modification et demande figure dans le journal d’activité du projet, tout comme chaque formulaire rempli à partir de champs personnalisés ou de suppositions.

  • 50 champs personnalisés par projet, en Free et en Team, champs prêts à l’emploi compris.
  • Un nom de 1 à 80 caractères ; une correspondance de 1 à 100 (3 à 100 pour « contient », ou 2 en chinois, japonais ou coréen, et jusqu’à 10 expressions) ; un chemin de page de 200 maximum.
  • Textes et modèles de 200 caractères maximum ; une liste de 2 à 20 réponses, de 100 caractères maximum chacune.
  • 20 demandes en attente par projet ; une note ou un motif de 300 caractères maximum.
  • Écrans d’inscription : jusqu’à 20 par site et 20 écrans d’app par projet ; un chemin de 200 caractères maximum, et un nom ou nom court d’écran de 80 maximum.
  • Aucun champ personnalisé sur les champs de mot de passe ou de paiement. Les valeurs sont visibles par tous les membres du projet, utilisez donc des données de test inventées : une valeur qui ressemble à un numéro de carte, à une clé privée, ou à une clé d’API ou un jeton dans l’un des formats listés (y compris les clés de Proxy Mail QA) est refusée avec « Cela ressemble à un vrai secret. Utilisez des données de test inventées. » Un mot de passe ne peut pas être distingué de données de test, n’en mettez donc jamais un vrai.
  • Pas de chiffres aléatoires dans un champ d’identifiant personnel : un modèle avec {digits:N} y est refusé avec « Les chiffres aléatoires ne vont jamais dans un champ d’identifiant personnel, car ils pourraient appartenir à une vraie personne. Donnez-lui plutôt une valeur de test fixe. »
  • Les listes déroulantes qui ne sont pas un <select> natif, comme React Select ou une listbox Headless UI, ne sont pas remplies, car Proxy Mail QA for Chrome n’ouvre jamais une liste dessinée par la page elle-même ; la carte indique quand elle ne peut pas y choisir.

La valeur d’un champ personnalisé est refusée avec « Cela ressemble à un vrai secret. Utilisez des données de test inventées. » quand une partie correspond à l’un de ces cas, dans un texte, un modèle, une option ou un élément de liste, et dans les réponses conservées sur un compte de test. Des mots avant une clé, comme token= ou un guillemet, ne la masquent pas. Une clé compte seulement au début de la valeur ou après un caractère qui n’est ni une lettre, ni un chiffre, ni _, donc xhf_… n’est pas lu comme une clé.

  • Un numéro de carte : 13 à 19 chiffres, avec ou sans espaces ou tirets entre eux, qui passent le contrôle de Luhn.
  • Une clé privée : tout ce qui contient -----BEGIN.

Clés et jetons refusés sur leur seul préfixe, clés de test comprises, donc sk_test_anything est refusé :

Fournisseur Commence par Ce que c’est
Stripe sk_live_, rk_live_, sk_test_, rk_test_ Clés secrètes et restreintes, live et test
Stripe whsec_ Secrets de signature de webhook
GitHub ghp_, github_pat_ Jetons d’accès personnels
GitLab glpat- Jetons d’accès personnels
npm npm_ Jetons d’accès
Slack xox, une lettre minuscule et -, comme xoxb- et xoxp- Jetons de bot, d’utilisateur et d’app
Supabase sb_secret_ clés d’API secrète
Anthropic sk-ant- clés d’API
OpenAI sk-proj-, sk-svcacct- Clés de projet et de compte de service

Clés et jetons refusés sur leur forme complète : le préfixe, puis les caractères qu’ont les clés de ce fournisseur. Une valeur inventée avec seulement le préfixe, comme hf_test ou key-test, est quand même enregistrée. Des caractères en plus après la forme sont aussi refusés, sauf là où il est indiqué « exactement ».

Fournisseur Commence par Puis
Proxy Mail QA qa_, ou qa_o, deux lettres minuscules et _, comme qa_oat_ Exactement 43 lettres, chiffres, - ou _ : clés d’API, et les jetons que reçoivent les apps d’IA à leur connexion
AWS AKIA 16 lettres majuscules ou chiffres : ID de clé d’accès
AWS ASIA Exactement 16 lettres majuscules ou chiffres : ID de clé d’accès temporaire
Google AIza 35 lettres, chiffres, - ou _ : clés d’API
Google GOCSPX- 28 lettres, chiffres, - ou _ : secrets client OAuth
GitHub gho_, ghu_, ghs_, ghr_ 36 lettres ou chiffres : jetons OAuth, d’utilisateur, d’app et d’actualisation
Resend re_ 8 lettres ou chiffres, _, puis 24 autres : clés d’API
SendGrid SG. 22 lettres, chiffres, - ou _, un point, puis 43 autres : clés d’API
Linear lin_api_ 40 lettres ou chiffres : clés d’API
Slack hooks.slack.com/services/ L’ID d’équipe (T…), l’ID de canal (B…) et un secret de 24 caractères : URL de webhooks entrants
Slack hooks.slack.com/workflows/, hooks.slack.com/triggers/ 43 lettres, chiffres, + ou / : URL de webhooks de workflow
Cloudflare cfut_, cfat_, cfk_ 40 lettres ou chiffres : jetons API d’utilisateur et de compte, et clés d’API globale
Supabase sbp_, sbp_oauth_, sbp_v0_ 40 lettres ou chiffres : jetons d’accès
OpenAI sk-admin- 74 ou 58 lettres, chiffres, - ou _, puis T3BlbkFJ et 58 autres : clés d’administration
OpenAI sk- 20 lettres ou chiffres, puis T3BlbkFJ et 20 autres : anciennes clés
Hugging Face hf_ 34 lettres ou chiffres : jetons d’accès
PyPI pypi-AgEIcHlwaS5vcmc 50 lettres, chiffres, - ou _ : jetons d’envoi
DigitalOcean dop_v1_, doo_v1_, dor_v1_ 64 chiffres et lettres de a à f, en minuscules : jetons d’accès personnels, OAuth et d’actualisation
Shopify shpat_, shpca_, shppa_, shpss_ 32 chiffres et lettres de a à f, en minuscules ou majuscules : jetons d’accès, jetons d’app et secrets partagés
Twilio SK 32 chiffres et lettres de a à f, en minuscules ou majuscules : SID clé d’API
Mailgun key- 32 lettres minuscules ou chiffres : clés d’API privées
Tout fournisseur eyJ 8 lettres, chiffres, - ou _ ou plus, puis un point : JSON Web Tokens

Tout le reste est enregistré : un mot de passe, une clé ou un jeton sans préfixe propre, et une clé ou un jeton d’un fournisseur non listé ici, comme Notion, Postman, Atlassian, Databricks ou Doppler, ou les jetons cfoat_ de Wrangler. Tenez vous-même les vrais à l’écart des champs personnalisés.

Une question sur cette page ?

Posez votre question dans la langue de votre choix. La documentation peut y répondre tout de suite, ou vous pouvez l'envoyer à l'équipe Proxy Mail QA, qui répond en anglais.

Interroger la documentation