Lantern

Bêta

Bibliothèque · Définition · Débutant

TemplateÀ lire

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

DeliveryQualité logicielleSaaSB2BScale-upPOPM

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

  1. 01Écrire l'en-tête : « # language: fr », la Fonctionnalité (en tant que, je veux, afin de), puis le Contexte commun.
  2. 02Ranger les scénarios sous le titre de leur user story (US-01, US-02…), sans en laisser un orphelin.
  3. 03Pour chaque règle, écrire au moins un scénario passant et un scénario non passant, avec leurs tags.
  4. 04Vérifier chaque scénario : une seule action dans Quand, un résultat observable dans Alors, aucun détail d'interface ni de technique.
  5. 05Au-dessus de chaque Plan du scénario, écrire la règle en commentaire, puis ajouter les cas limites au tableau.
  6. 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.
  7. 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

Une action cachée dans Étant donné, ou un état mis dans Quand : on ne sait plus ce qui déclenche le résultat.
« PASSANT / NON PASSANT » écrit en texte libre au lieu de tags : impossible de filtrer ou d'exécuter.
Un tableau d'exemples sans la règle écrite : quatre lignes, et tous les autres cas restent ouverts.
Des scénarios orphelins, rattachés à aucune user story : on ne sait plus ce qu'ils couvrent.
Décrire l'interface (cliquer, champ, écran) au lieu du comportement : le scénario casse au premier changement de maquette.

Mes notes

ce que tu retiens, ton contexte

À jour · stocké dans ce navigateur

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

gherkincritères d'acceptationétant donné quand alorsgiven when thenscénarioplan du scénariocas passantscas non passantsbddcucumberfeature

À lire juste après

ce que cette fiche appelle