Bibliothèque · Définition · Débutant
Gherkin - écrire des critères d'acceptation passants et non passants
Étant donné / Quand / Alors : des scénarios en langage métier que le PO, le développeur et le testeur lisent pareil, avec les cas passants, les cas non passants et les règles derrière les tableaux d'exemples.
Pour qui, pour quand
En résumé
Un fichier Gherkin (.feature) commence par « # language: fr », puis une Fonctionnalité qui dit qui veut quoi et pourquoi. Le Contexte pose une fois ce qui vaut pour tous les scénarios. Chaque Scénario décrit un seul comportement : Étant donné (l'état de départ), Quand (une seule action, ou un seul événement), Alors (le résultat observable). Et et Mais prolongent l'étape précédente. Un Plan du scénario rejoue le même scénario sur un tableau d'Exemples, écrit avec des « | ».
Une story n'est pas couverte tant qu'elle n'a que des cas passants. Pour chaque règle, il faut aussi le cas non passant : l'information absente, la saisie vide, l'utilisateur qui ne répond pas, la correction sans motif. On les marque avec des tags (« @passant », « @non-passant »), pas avec du texte libre, pour pouvoir les filtrer et les exécuter.
Un tableau d'exemples ne remplace pas la règle. Quatre lignes ne disent pas ce qui se passe dans les autres cas. On écrit la règle en commentaire au-dessus du plan, puis on ajoute une ligne par cas limite. Même chose pour les mots flous comme « 2 ou 3 », « niveau de confiance » ou « la suite du parcours » : sans règle écrite, ils ne se testent pas.
Exemple : la zone de menace d'un outil de veille concurrentielle. Une story, sa règle écrite au-dessus du tableau, un scénario passant et un non passant.
# language: fr
Fonctionnalité: Zone de menace
En tant que PM
Je veux une zone de menace argumentée, que je peux corriger
Afin de décider s'il faut surveiller, ajuster ou riposter
Contexte:
Étant donné que je suis connecté en tant que PM
# US-05 Obtenir une zone de menace argumentée, et la corriger
# Règle : riposter si recouvrement fort ET exposition forte ET capacité forte ;
# surveiller si recouvrement faible ou moyen ET exposition faible ; ajuster sinon.
@passant
Plan du scénario: La zone suit la règle
Étant donné recouvrement <rec>, exposition <expo>, capacité <cap>
Quand la zone de menace s'affiche
Alors la zone proposée est <zone>
Exemples:
| rec | expo | cap | zone |
| fort | fort | forte | riposter |
| fort | fort | faible | ajuster |
| faible | fort | forte | ajuster |
| moyen | faible | forte | surveiller |
@passant
Scénario: Le PM corrige la zone en apportant une information
Étant donné que la zone proposée est « riposter »
Quand je la passe à « surveiller » avec le motif « information contextuelle »
Alors la zone « surveiller » est utilisée pour la suite du parcours
Et la correction est enregistrée avec son motif
@non-passant
Scénario: Le PM corrige sans motif
Étant donné que la zone proposée est « riposter »
Quand je passe la zone à « ajuster » sans choisir de motif
Alors la correction est refusée
Et le message « Indiquez s'il s'agit d'une erreur de l'IA ou d'une information contextuelle » s'afficheÉtape
dans l'ordre, sans en sauter
- 01Écrire l'en-tête : « # language: fr », la Fonctionnalité (en tant que, je veux, afin de), puis le Contexte commun.
- 02Ranger les scénarios sous le titre de leur user story (US-01, US-02…), sans en laisser un orphelin.
- 03Pour chaque règle, écrire au moins un scénario passant et un scénario non passant, avec leurs tags.
- 04Vérifier chaque scénario : une seule action dans Quand, un résultat observable dans Alors, aucun détail d'interface ni de technique.
- 05Au-dessus de chaque Plan du scénario, écrire la règle en commentaire, puis ajouter les cas limites au tableau.
- 06Chasser les mots flous (« quelques », « la suite », « 2 ou 3 ») : soit on écrit la règle, soit on en fait une question au métier.
- 07Faire relire le fichier par le métier et par un testeur avant le développement.
Questions à poser
avant de te lancer
- →Chaque règle a-t-elle son cas non passant ?
- →Mes tableaux d'exemples couvrent-ils les cas limites, ou seulement les cas faciles ?
- →Un testeur peut-il dire, sans me demander, si le scénario passe ?
- →Chaque renvoi (« la suite du parcours », « le niveau de confiance ») pointe-t-il vers un scénario qui le décrit ?
Ce qui coûte cher
les pièges déjà vus sur ce sujet
Mes notes
ce que tu retiens, ton contexte
Situations couvertes
- · Je dois écrire des critères d'acceptation
- · Je dois rédiger des user stories
- · Je dois préparer la recette d'une fonctionnalité
Provenance
Spécification Contre-feu - critères d'acceptation en Gherkin
ajoutée le 2026-11-02
Mots-clés
À lire juste après
ce que cette fiche appelle