Système d’avertissement de GDScript

Le système d'avertissement de GDScript complète le typage statique (mais il peut aussi fonctionner sans typage statique). Il est là pour vous aider à éviter les erreurs difficiles à repérer pendant le développement, et qui peuvent conduire à des erreurs d'exécution.

Vous pouvez configurer les avertissements dans les paramètres du projet, dans la section intitulée Gdscript :

Warning system project settings

Paramètres de projet du système d'avertissement

Vous pouvez trouver une liste des avertissements pour le fichier GDScript actif dans la barre d'état de l'éditeur de script. L'exemple ci-dessous comporte 3 avertissements :

Warning system example

Exemple du système d'avertissement

Pour ignorer des avertissements spécifiques dans un fichier, insérez un commentaire spécial de la forme #warning-ignore:warning-id, ou cliquez sur le lien ignorer à droite de la description de l'avertissement. Godot ajoutera un commentaire au-dessus de la ligne correspondante et le code ne déclenchera plus l'avertissement correspondant :

Warning system ignore example

Exemple où le système d'avertissement est ignoré

Vous pouvez aussi choisir d'ignorer, non pas un, mais tous les avertissements d'un certain type dans le fichier avec # warning-ignore-all:warning-id. Pour ignorer tous les avertissements de tous les types dans un fichier, ajoutez lui le commentaire # warnings-disable.

Les avertissements n'empêcheront pas le jeu de fonctionner, mais vous pouvez les transformer en erreurs si vous le souhaitez. De cette façon, votre jeu ne sera pas compilé à moins que vous ne corrigiez tous les avertissements. Allez à la section GDScript des Paramètres du projet pour activer cette option. Voici le même fichier que l'exemple précédent avec les avertissements d'erreurs activées :

Warnings as errors

Les avertissements en tant qu'erreurs