Tester et déboguer les scripts Shopify

Vous pouvez utiliser les fonctionnalités de débogage de l’application Script Editor pour tester et déboguer vos scripts.

L’application Script Editor vérifie que votre code ne comporte pas d’erreurs de base lorsque vous rédigez un script :

Rapport d’erreurs dans l’application Script Editor

Elle signale également les erreurs qui se produisent dans les scripts publiés et vous envoie un e-mail lorsque ces erreurs se produisent :

Capture d’écran des erreurs des scripts publiés dans l’application Script Editor

Il est conseillé de corriger les erreurs, comme les erreurs de syntaxe, avant de tester ou de publier un script. Si votre script comporte des erreurs de syntaxe, son test ne fonctionnera probablement pas.

Si vous avez besoin de plus d’informations sur une erreur de script, passez le curseur de la souris sur l’icône x rouge dans la marge de l’application Script Editor :

Le survol du X dans la marge de l’application Script Editor révèle des détails sur les erreurs de syntaxe

Duplication de scripts

Si vous devez tester ou déboguer un script publié parce qu’il contient des erreurs, dupliquez le script et publiez la copie. Il est préférable de déboguer le script qui a été publié lorsque l’erreur s’est produite, car les détails de l’erreur sont joints à cette version.

Les détails des erreurs de production joints à un script ne sont pas copiés lorsque vous dupliquez un script.

Pour dupliquer un script :

  1. Dans l’application Script Editor, cliquez sur le nom du script que vous souhaitez dupliquer.

  2. Cliquez sur Dupliquer pour faire une copie du script.

Déboguer les erreurs de production

Pour déboguer une erreur de production :

  1. Dupliquez le script qui contient les erreurs.

  2. Publiez le script dupliqué afin qu’une version du script soit disponible pour vos clients dans votre boutique. Cette étape suppose que le script ne contient pas un nombre d’erreurs si important qu’il doive être dépublié (supprimé) de votre boutique.

  3. Déboguez le script d’origine à l’aide des détails d’erreur qui lui sont joints.

Tester un script

Pendant que vous travaillez sur un script, vous pouvez le tester dans l’application Script Editor pour vous assurer qu’il fonctionne avant de le publier dans votre boutique.

Pour tester un script :

  1. Dans l’application Script Editor, ouvrez le script que vous souhaitez tester.
  2. Pour modifier un panier de test, cliquez sur Saisie. Vous pouvez également cliquer sur Les deux pour voir le code du script et le panier de test en même temps. La vue de saisie affiche les options permettant de modifier un panier pour tester votre script. Vous pouvez ajouter des produits, des clients, des codes de réduction, des informations sur le client et des informations d’expédition en fonction de ce que vous voulez tester avec votre script.
    • Saisissez du texte dans la section Produits pour rechercher et ajouter des produits à la commande de test.
    • Saisissez du texte dans la section Code de réduction pour rechercher et ajouter des codes de réduction à la commande de test.
    • Saisissez du texte dans la section Informations sur le client pour rechercher et ajouter des clients à la commande de test.
    • Cliquez sur Ajouter ou Modifier dans la section Adresse de livraison pour changer l’adresse de livraison de la commande de test.
  3. Cliquez sur Exécuter le script pour voir les modifications que le script apporte à votre panier de test.
    • Si votre script s’exécute correctement, la section Sortie est mise à jour pour afficher les modifications appliquées par le script. Si la section Sortie ne change pas ou si des modifications inattendues s’affichent, il se peut que votre script contienne des erreurs. Vérifiez la zone Console dans la section Code source Ruby pour résoudre les erreurs de script :
    • La zone Console signale l’utilisation des ressources du script. Les scripts plus complexes utilisent plus de ressources. Les scripts disposent d’une quantité limitée de ressources processeur et de mémoire.
  4. Lorsque vous avez terminé :
    • cliquez sur Enregistrer le brouillon pour mettre à jour et enregistrer un brouillon non publié du script
    • cliquez sur Activer pour mettre à jour et publier le script.

Se désabonner des notifications d’erreur

Lorsque vous publiez un script, vous êtes automatiquement abonné aux notifications par e-mail pour ce script. Chaque fois qu’une erreur de production se produit dans ce script, vous recevez un e-mail à ce sujet. Vous pouvez ensuite ouvrir l’application Script Editor pour en savoir plus sur l’erreur et la déboguer.

Vous pouvez vous désabonner de ces e-mails après en avoir reçu un. Pour vous désabonner, ouvrez la page Erreur de production de l’erreur et cliquez sur Se désabonner.

Prochaines étapes

Une fois que votre script vous satisfait, vous pouvez le publier dans votre boutique. Vous pouvez également mettre à jour vos fichiers de modèle Liquid afin que votre boutique en ligne réponde aux modifications apportées par vos scripts.

En savoir plus

En savoir plus sur :