Skip to main content

Tests automatisés des Server Scripts

But

Les tests automatisés valident la logique métier des Cloud Scripts sans passer par l'UI Unity. Ils servent surtout à protéger les moteurs complexes By Module : création des données, bills, answer key, grading, inventaire et factories.

Emplacement

Les tests se trouvent sous node.js/backend/braincloud/tests/.

Dossier Ce qui est testé unit/by_module_tests/answer_key_tests/ Génération des bonnes réponses, fonctions auxiliaires, petty cash. unit/by_module_tests/bills_tests/ Création et utilitaires des bills. unit/by_module_tests/classes_tests/ Classes métier comme l'inventaire. unit/by_module_tests/create_module_type_data_tests/ Génération initiale du Module Type Data. unit/by_module_tests/factories_tests/ Factories serveur, notamment BillFactory. unit/by_module_tests/grade_module_tests/ Correction, états financiers, formulaires fiscaux et modules spécialisés.

Infrastructure de test

  • tests/lib/test_base.js : base commune;
  • tests/lib/unit_test_core.js : orchestration des tests;
  • tests/utils/test_data.js : helpers/données de test;
  • tests/data/ : fixtures (companies, conditions, employees, partners, products, salaries, services);
  • tests/utils/billtypedata.json et reference.json : références utilisées par les suites.

Quand ajouter un test

Ajouter ou modifier un test dès qu'un changement touche une fonction pure ou déterministe du moteur serveur. Les zones à protéger en priorité sont :

  • nouveau type de bill;
  • nouvelle règle d'answer key;
  • nouvelle règle de grading;
  • modification de création du Module Type Data;
  • modification d'inventaire ou de calcul qui influence plusieurs pages;
  • nouvelle factory ou branche de factory.

Stratégie

flowchart LR
CHANGE[Changement métier] --> UNIT[Test ciblé]
UNIT --> EDGE[Cas limites]
EDGE --> REG[Régression du module]
REG --> DEBUG[Debug local si le problème dépend de documents réels]

Tests vs debug local

Les tests automatisés ne remplacent pas Debug local des Server Scripts BrainCloud. Un test unitaire valide une fonction avec des fixtures contrôlées; le debug local permet d'exécuter un vrai Cloud Script avec des documents issus de MongoDB ou récupérés depuis BrainCloud.

Lancer réellement les tests

Le projet possède un runner Web, pas seulement des fichiers .test.js.

Runner Web recommandé

Depuis node.js/backend/braincloud/ :

node tests/web-runner/server.js

Le serveur écoute par défaut sur http://localhost:3000 et ouvre automatiquement le navigateur. L'UI liste les suites sous tests/unit/by_module_tests, permet de sélectionner des tests individuels et de lancer en mode normal ou debug.

Mode normal vs debug

    normal : les fichiers By Module sont instrumentés avec Istanbul et un rapport HTML est généré sous tests/test-reports/; debug : global.DEBUG_MODE = true, l'instrumentation coverage est désactivée et aucun rapport n'est généré.

    Dépendance MongoDB locale

    tests/lib/test_base.js crée MongoDBClient et s'authentifie avant d'initialiser les utils. Si les tests ne démarrent même pas, vérifier d'abord le MongoDB local et sa configuration avant de chercher une régression métier.

    Point à connaître : game-specific de test

    Le bootstrap de test inclut actuellement explicitement /acc2/utils/acc2_utils. Si une nouvelle suite dépend réellement d'une différence Acc1/Acc2, ne pas supposer que le runner change automatiquement de game-specific.

    Créer un nouveau test

      Placer le fichier sous la catégorie appropriée dans tests/unit/by_module_tests/. Créer un TestSuite. Ajouter les cas avec suite.addTest(name, fn). Initialiser la fixture commune avec suite.init() si nécessaire. Utiliser les assertions de unit_test_core.js : areEqual, isTrue, inRange, etc. Ajouter les fixtures réutilisables dans tests/data ou tests/utils, pas en duplicata dans chaque test. Lancer le test seul, puis la suite complète du domaine.

      Quand un test doit être ajouté

      Tout changement Answer Key/Grading/Create Module Type Data/BillFactory/inventory doit avoir au minimum un test qui aurait échoué avant le changement. Un bug corrigé sans test de régression est considéré incomplet lorsque la fonction est testable localement.

      Back to top