DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion du débogage
  • Présentation
  • Les assertions
  • Mise en place
  • Conseil
  • Personnalisation de la fenêtre des assertions
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Présentation
WINDEV, WEBDEV et WINDEV Mobile disposent en standard de plusieurs outils et fonctionnalités pour aider à mettre au point et à optimiser les applications ou sites.
Les principales fonctionnalités offertes en termes de mise au point sont les suivantes :
Les assertions
Une assertion permet de vérifier une condition lors de l'exécution de l'application.
Si la condition n'est pas vérifiée, une boîte d'information s'affiche avec le détail de la vérification.
Le développeur a alors accès à la pile d'exécution, c'est-à-dire tous les appels qui ont abouti à ce résultat.
Mise en place
Pour définir une assertion, il suffit d'utiliser la fonction dbgAssertion avec en paramètre :
  • la condition à vérifier,
  • le message à afficher si jamais la condition n'est pas vérifiée.
// Variable CClient
clClient est un CClient
// Création du client
CréerClient(clClient)
// L'objet clClient doit avoir été instancié
dbgAssertion(clClient<>Null, "L'objet n'a pas été instancié")
Par défaut, les assertions sont actives uniquement en mode test.
Il est possible d'activer les assertions en déploiement : il suffit d'utiliser la fonction dbgActiveAssertion :
dbgActiveAssertion(Vrai)

Attention : La condition utilisée dans l'assertion est exécutée par le WLangage uniquement lorsque les assertions sont actives. Le fonctionnement peut donc être différent en mode test et en mode exécutable.
Il faut être particulièrement vigilant lors de l'utilisation de fonctions dans la condition fournie à la fonction dbgAssertion. En effet, si la fonction utilisée réalise une initialisation ou une connexion, cette opération ne sera pas réalisée dans l'application utilisée en mode "exécutable".
En revanche, ce mode de fonctionnement permet de réaliser "plus de tests" sans ralentir l'application en exploitation. La mise au point des applications est ainsi plus rapide.

Conseil

Les assertions peuvent servir pour tester des cas "spécifiques" ou vérifier les "prérequis" d'une fonction. Il est ainsi possible de tester le cas qui ne devrait jamais arriver :
  • utilisation d'une chaîne vide alors qu'un nom logique est attendu,
  • saisie d'un chemin vers un fichier inexistant, ...
Les assertions ne peuvent pas remplacer la gestion classique des erreurs. Mais mettre une assertion permet d'être prévenu et de retrouver pourquoi un problème est survenu grâce à la pile d'exécution.
Les assertions permettent également de guider lors d'un développement à plusieurs développeurs : le code "appelant" ne doit pas provoquer d'assertions dans le code "appelé".
WINDEV

Personnalisation de la fenêtre des assertions

Par défaut, les fenêtres de gestion des erreurs, des exceptions et des assertions sont intégrées à l'application. Ces fenêtres sont disponibles en français et en anglais.
Pour personnaliser ces fenêtres (ou pour les traduire dans une autre langue), il suffit d'importer les fenêtres correspondantes dans votre projet.
  1. Dans le ruban :
    • WINDEV Sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez "Des éléments WINDEV et leurs dépendances".
    • WINDEV Mobile Sous le volet "Projet", dans le groupe "Projet", déroulez "Importer" et sélectionnez "Des éléments WINDEV Mobile et leurs dépendances".
  2. Sélectionnez le répertoire des éléments à importer : "Programs\Data\Preset Windows\FR\Assertion - Erreur - Exception".
  3. Sélectionnez les fenêtres à importer :
    WINDEVWINDEV MobileType de fenêtre
    WD_AfficheAssertion.wdwWM_AfficheAssertion.WPWFenêtre de gestion des assertions
    WD_AfficheErreur.wdwWM_AfficheErreur.WPWFenêtre de gestion des erreurs
    WD_AfficheException.wdwWM_AfficheException.WPWFenêtre de gestion des exceptions
    WD_ModeleErreur.wdtModèle utilisé par les fenêtres WINDEV.
  4. Validez. La ou les fenêtres sont intégrées à votre projet. Ces fenêtres seront automatiquement utilisées et remplaceront les fenêtres par défaut.
Remarque : Pour utiliser les fenêtres par défaut, il suffit de supprimer les fenêtres importées de votre projet.
Version minimum requise
  • Version 11
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 31/08/2023

Signaler une erreur ou faire une suggestion | Aide en ligne locale