בדיקות

בדיקות יחידה של תבניות מותאמות אישית ב-Google Tag Manager עוזרות לכם לאמת את הפונקציונליות של התבניות שלכם. אפשר ליצור קבוצה של בדיקות לכל תבנית, ואפשר להריץ אותה בלי צורך לפרוס את התג. כך תוכלו לבדוק באופן רציף את התנהגות התבנית בזמן הפיתוח. כל בדיקה יכולה לספק ערכי קלט לדוגמה, קריאות לפונקציות לדוגמה והצהרה על התנהגות בקוד.

מגבלות

• בדיקות יחידה לא בודקות כללי אימות, אבל ניתן לבדוק אותן באופן ידני באמצעות הלחצן הפעלת קוד.
• בבדיקות יחידה לא מתבצעות בדיקות הרשאה בממשקי API מדומים.

במדריך הזה נסביר איך לכתוב בדיקות יחידה בתבנית המותאמת אישית. בדוגמה הזו נוצרת תבנית משתנה שמקבלת מחרוזת קלט ומחזירה את הגרסה הגדולה של אותה מחרוזת.

1. יוצרים תבנית משתנה חדשה. לוחצים על תבניות בחלונית הניווט הימנית ולוחצים על חדש בקטע תבניות משתנים.

2. לוחצים על שדות.

3. לוחצים על הוספת שדה ובוחרים באפשרות קלט טקסט. נותנים שם לשדה text1 ומגדירים את השם המוצג כ-"Text 1".

4. בכרטיסייה קוד מחליפים את קוד ברירת המחדל ב-JavaScript שבארגז החול:

   let input = data.text1;
   return input.toUpperCase();
   

5. לוחצים על בדיקות כדי לפתוח את כרטיסיית הבדיקה.

6. לוחצים על Add Test (הוספת בדיקה) ומשנים את שם הבדיקה מ-" Handling Test 1" ל-" Handles string".

7. לוחצים על סמל ההרחבה () כדי להציג את עורך ה-JavaScript שבארגז חול של הבדיקה. מחליפים את הקוד ב-JavaScript שבארגז חול (sandbox):

   // Call runCode to run the template's code with a lowercase string
   let variableResult = runCode({text1: 'this is a test'});
   // Validate that the result of runCode is an uppercase string.
   assertThat(variableResult).isEqualTo('THIS IS A TEST');
   

   הבדיקה מעבירה את המחרוזת 'this is a test' למשתנה ומוודאת שהמשתנה יחזיר את הערך הצפוי 'THIS IS A TEST'. ה-API runCode משמש להרצת קוד התבנית בכרטיסייה קוד. הארגומנט runCode הוא אובייקט המשמש כנתונים גלובליים. ה-API assertThat מחזיר אובייקט שיכול לשמש כהוכחה שוטפת לערך של נושא.

8. לוחצים על ▶ הרצת בדיקות כדי להריץ את הבדיקה. הפלט של הבדיקה יופיע במסוף.

   הלחצן ▶ הרצת בדיקות מפעיל את כל הבדיקות המופעלות בתבנית, לפי הסדר שבו הן מוצגות. כדי לשנות את הסדר, משתמשים בסמל הגרירה (⠿). אפשר להפעיל או להשבית באופן זמני בדיקה על ידי לחיצה על העיגול שמימין לשם הבדיקה. כדי להפעיל בדיקה יחידה, לחץ על הלחצן ▶ שמופיע בעת העברת העכבר מעל הבדיקה.

   המסוף צריך להדפיס את מספר הבדיקות הכולל ואת מספר הבדיקות שנכשלו, אם יש כאלה. במקרה הזה, הופעלה רק בדיקה אחת והיא צריכה לעבור.

9. לוחצים על הוספת בדיקה שוב כדי להוסיף בדיקה שנייה. משנים את שם הבדיקה מ"ללא בדיקה לבדיקה 2" ל"ידיות לא מוגדרות".

10. לוחצים על הבדיקה כדי להרחיב אותה ולהציג את עורך JavaScript בארגז החול. יש להזין JavaScript בארגז חול בעורך:

    let variableResult = runCode({});
    assertThat(variableResult).isEqualTo(undefined);
    

    הערה: runCode מתבצעת עם אובייקט ריק. כלומר, הערך של השדה text1 יהיה undefined במקרה הבדיקה הזו.

11. לוחצים על ▶ הרצת בדיקות כדי להריץ את כל הבדיקות בבת אחת. הפלט של הבדיקה יופיע במסוף.

    הבדיקה של הטיפול בכינויים לא מוגדרים נכשלת. חדשות טובות, מצאת באג!

12. לוחצים על קוד כדי לחזור ולערוך את קוד JavaScript בארגז החול של התבנית. מעדכנים את קוד JavaScript שבארגז החול באופן הבא:

    const getType = require('getType');
    
    let input = data.text1;
    if (getType(input) !== 'string') {
      return input;
    }
    return input.toUpperCase();
    

    הקוד המעודכן תואם לשיטות המומלצות לאימות המשתנה input לפני שמשתמשים בו.

13. לוחצים על בדיקות כדי לחזור לרשימה של מקרי הבדיקה.

14. לוחצים על ▶ הפעלת בדיקות כדי להפעיל שוב את כל מקרי הבדיקה. הפעם הבדיקה של הכינויים לא מוגדרת צריכה לעבור.

15. לוחצים על שמירה וסוגרים את כלי העריכה של התבניות.