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 :

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 :

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 :

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 :