Aller au contenu
Criée

Du métier au cas de test

Traduire une règle en « Étant donné, quand, alors », choisir des données qui la prouvent, couvrir les cas limites.

Leçon 712 min

À la fin de cette leçon

  • Traduire une règle métier en cas de test étant donné, quand, alors
  • Choisir les cas limites qui mettent une règle à l’épreuve
  • Traiter une règle non couverte et interpréter un mutant qui survit
Dans cette leçon4

Une règle métier arrive rarement sous forme de test. Elle arrive sous forme de phrase : « l'ordre au marché est prioritaire sur l'ordre à prix limité ». Votre travail consiste à la traduire en un état de départ, une action et un résultat attendu, vérifiables par une machine.

Cas de test

Règle métier écrite en « Étant donné, quand, alors » : un état de départ, une action, un résultat attendu.

De la phrase au test, en trois questions

Prenons la règle du RG BVMAC 2025, art. 159 : l'ordre au marché est prioritaire sur l'ordre à prix limité.

  1. Étant donné : quel état rend la règle observable ? Il faut un achat limité arrivé avant un achat au marché, sinon la priorité de temps suffirait à expliquer le résultat.
  2. Quand : quelle action déclenche la règle ? Un fixing où les deux achats sont servis, mais pas en totalité ensemble.
  3. Alors : quel résultat, précis et chiffré ? La première exécution revient à l'ordre au marché.
it("sert l'ordre au marché avant l'ordre limité arrivé plus tôt", () => {
  const r = fixing([
    { id: 'a1', sens: 'achat', quantite: 30, limite: 10050, rang: 1 },
    { id: 'a2', sens: 'achat', quantite: 20, limite: null, rang: 2 },
    { id: 'v1', sens: 'vente', quantite: 25, limite: 9950, rang: 3 },
    { id: 'v2', sens: 'vente', quantite: 40, limite: 10050, rang: 4 },
  ], 10000)
  expect(r.executions[0]).toEqual({ achat: 'a2', vente: 'v1', prix: 10050, quantite: 20 })
})

Le choix des données fait le test. Avec a2 arrivé en premier, ce test passerait même si le moteur ignorait la règle : il ne prouverait rien.

Le prix attendu, 10 050, se prévoit avec les règles de départage de Le fixing en code : calculez la courbe avant d'écrire le « alors », sinon vous recopiez la sortie du moteur au lieu de la vérifier.

La scène suit la vie de ce test. Un premier jet, où l'ordre au marché arrive le premier, passe contre le moteur ; il passe aussi contre un mutant qui sert les acheteurs par rang seul, sans la règle. Le second jet, celui du code ci-dessus, passe contre le moteur et échoue contre le mutant : lui seul prouve la règle.

La vie d’un test1/7

« L’ordre au marché est prioritaire sur l’ordre à prix limité. »

règle reçue

Une phrase du métier

« L’ordre au marché est prioritaire sur l’ordre à prix limité » (RG BVMAC 2025, art. 159). Il faut en faire un test.

Les cas limites d'un moteur

Les bogues se logent aux bords. Pour chaque règle, cherchez les valeurs qui la mettent à l'épreuve :

  • quantités : zéro, négative, décimale, exactement égale à ce qui attend en face ;
  • prix : égalité de prix entre deux ordres, limite exactement égale au meilleur prix opposé, prix non entier ;
  • ordres au marché : sans contrepartie, seuls des deux côtés, face à un carnet vide ;
  • fixing : aucun croisement, égalité de volume entre plusieurs prix, déséquilibres de signes opposés ;
  • cycle de vie : annuler un ordre déjà exécuté, annuler deux fois, réutiliser un identifiant.

Choisissez un cas, lisez la règle, puis lancez le test contre le moteur.

Du métier au cas de test
Étant donné
un carnet vide
quand
un achat de 0 titre à 10 000 arrive
alors
le moteur refuse l’ordre par une exception
const c = new Carnet()
expect(() =>
  c.passer({ id: 'a1', sens: 'achat', quantite: 0, limite: 10000 }),
).toThrow()

De mémoire : pourquoi le test de priorité du marché fait-il arriver l'ordre limité en premier ?

Une règle que le moteur ne connaît pas encore

Le règlement admet des ordres « tout ou rien », exécutés en totalité ou pas du tout (RG BVMAC 2025, art. 167). Le type Ordre du moteur pédagogique n'a aucun champ pour l'exprimer. Écrivez quand même le cas : il devient la spécification de la fonctionnalité.

it.todo('un ordre tout ou rien de 50 face à 30 disponibles ne produit aucune exécution')

Défi : votre premier cas de test

Écrivez en Étant donné / quand / alors, puis en TypeScript, la règle suivante : modifier un ordre fait perdre la priorité de temps si la limite change ou si la quantité augmente, mais la conserve si la quantité diminue (Euronext Trading Manual, 2021, section 2). Le moteur n'a pas de méthode de modification : décidez d'abord comment la représenter (annuler puis repasser ? nouvelle méthode ?), puis écrivez les deux tests.

Une réponse possible, avec ses tests, se trouve dans Modifier et annuler un ordre.

Plus loin

Qui teste les tests ?

La scène l'a montré : un test vert ne dit rien s'il resterait vert sans la règle. Le test de mutation systématise cette question.

Test de mutation

Technique qui modifie volontairement le code (un mutant) pour vérifier qu'au moins un test échoue.

Un outil de mutation modifie le code source lui-même : un >= devient >, une condition disparaît. Sans outil, vous pouvez déjà simuler un mutant ciblé en transformant les entrées. Ici, remplacer chaque ordre au marché par un ordre limité au prix le plus agressif du carnet supprime exactement la règle « marché d'abord », sans changer le prix d'équilibre :

// Mutant : l'ordre au marché devient un ordre limité, il perd sa priorité
const sansRegleMarche = (ordres: Ordre[]) =>
  fixing(
    ordres.map((o) => (o.limite === null ? { ...o, limite: o.sens === 'achat' ? 10050 : 9950 } : o)),
    10000,
  )

const ordres: Ordre[] = [
  { id: 'a1', sens: 'achat', quantite: 30, limite: 10050, rang: 1 },
  { id: 'a2', sens: 'achat', quantite: 20, limite: null, rang: 2 },
  { id: 'v1', sens: 'vente', quantite: 25, limite: 9950, rang: 3 },
  { id: 'v2', sens: 'vente', quantite: 40, limite: 10050, rang: 4 },
]

fixing(ordres, 10000).executions[0]
// { achat: 'a2', vente: 'v1', prix: 10050, quantite: 20 }  le test passe
sansRegleMarche(ordres).executions[0]
// { achat: 'a1', vente: 'v1', prix: 10050, quantite: 25 }  le test échoue : mutant tué

Pas à pas : le mutant garde les mêmes prix candidats (9 950 et 10 050), donc le même prix d'équilibre ; seule la priorité change. a1 et a2 sont désormais deux achats limités à 10 050, et a1, arrivé le premier, passe devant. Le test attend a2 : il échoue, la règle est protégée.

Coût. Un outil de mutation crée des dizaines de mutants et relance toute la suite pour chacun : n mutants, n exécutions de la suite. Réservez-le au cœur du moteur (tri, départage, répartition), là où une condition inversée coûte le plus cher.

Des cas limites en tableau

Les cas limites d'une même règle partagent le même test ; seules les données changent. it.each les écrit une fois :

it.each([0, -5, 2.5, NaN])('refuse la quantité %s', (quantite) => {
  const c = new Carnet()
  expect(() => c.passer({ id: 'x', sens: 'achat', quantite, limite: 10000 })).toThrow()
})

Les quatre cas passent : le moteur refuse ces quantités. Écrivez la même table pour la limite, avec -3, 10 000,5 et NaN : les trois tests sont rouges, car le moteur accepte ces limites (limite connue n° 2 de la fiche du contrat du moteur). Gardez-les rouges ou marquez-les comme défaut connu, mais ne les supprimez pas : un test supprimé ne documente plus rien.

De mémoire, leçon 6 : quelle différence entre un test d'exemple et un test par propriétés ? Lequel tue un mutant ?

À toi de jouer

Dans un cas de test, la partie « alors » doit être...

1Dans un cas de test, la partie « alors » doit être...

Quel cas limite met le mieux à l'épreuve la priorité de temps ?

2Quel cas limite met le mieux à l'épreuve la priorité de temps ?

Le moteur ne gère pas encore les ordres tout ou rien. Que faites-vous du cas ?

3Le moteur ne gère pas encore les ordres tout ou rien. Que faites-vous du cas ?

Un mutant survit à toute votre suite de tests. Cela signifie...

4Un mutant survit à toute votre suite de tests. Cela signifie...

À lire ensuite : AMF, « Choisir et passer un ordre de bourse : ce qu’il faut savoir »

Une question ? Posez-la à votre enseignant, ou à un assistant IA en lui donnant le titre de cette leçon.

Partager :WhatsAppLinkedIn

Pour aller plus loin