Testler

Google Etiket Yöneticisi özel şablonlarına yönelik birim testleri, şablonlarınızın işlevlerini doğrulamanıza yardımcı olur. Her şablon için, etiketinizi dağıtmaya gerek kalmadan çalıştırabileceğiniz bir dizi test oluşturabilirsiniz. Böylece, geliştirme sırasında şablonunuzun davranışını sürekli olarak test edebilirsiniz. Her test örnek giriş değerleri, örnek işlev çağrıları ve kod davranışı sağlayabilir.

Sınırlamalar

  • Birim testleri doğrulama kurallarını kontrol etmez, ancak Kodu Çalıştır düğmesini kullanarak doğrulamayı manuel olarak kontrol edebilirsiniz.
  • İzin kontrolleri, birim testlerindeki sahte API'lerde gerçekleşmez.

Bu kılavuzda, özel şablonunuz için birim testlerinin nasıl yazılacağı açıklanmaktadır. Bu örnekte, bir giriş dizesi alan ve söz konusu dizenin büyük halini döndüren bir değişken şablonu oluşturulur.

  1. Yeni bir değişken şablonu oluşturun. Sol gezinme menüsünden Şablonlar'ı ve Değişken Şablonlar bölümünün altındaki Yeni'yi tıklayın.

  2. Alanlar'ı tıklayın.

  3. Alan Ekle'yi tıklayın ve Metin girişi'ni seçin. text1 alanına bir ad verin ve görünen adı "Metin 1" olarak ayarlayın.

  4. Kod sekmesinde varsayılan kodu bu korumalı alana alınmış JavaScript ile değiştirin:

    let input = data.text1;
    return input.toUpperCase();
    
  5. Test sekmesini açmak için Testler'i tıklayın.

  6. Test Ekle'yi tıklayın ve "Başlıksız test 1" olan testin adını "Dizeler tutma yeri" olarak değiştirin.

  7. Testin korumalı alana alınmış JavaScript düzenleyicisini ortaya çıkarmak için genişlet simgesini () tıklayın. Kodu şu korumalı alanlı JavaScript ile değiştirin:

    // 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');
    

    Bu test, 'this is a test' dizesini değişkene iletir ve değişkenin beklenen 'THIS IS A TEST' değerini döndürdüğünü doğrular. Şablon kodunu Kod sekmesinde çalıştırmak için runCode API kullanılır. runCode bağımsız değişkeni, veri global olarak kullanılan bir nesne. assertThat API, bir nesnenin değeri hakkında kısa sürede özetler oluşturmak için kullanılabilecek bir nesne döndürür.

  8. Testi çalıştırmak için ▶ Testleri Çalıştır'ı tıklayın. Testin sonucu Konsol'da gösterilir.

    ▶ Testleri Çalıştır düğmesi, şablondaki etkin testlerin tümünü gösterilen sırada çalıştırır. Sırayı değiştirmek için sürükleme simgesini (⠿) kullanın. Test adının solundaki daireyi tıklayarak testi geçici olarak etkinleştirebilir veya devre dışı bırakabilirsiniz. Tek bir testi çalıştırmak için fareyi testin üzerine getirdiğinizde görünen ▶ düğmesini tıklayın.

    Konsol, çalıştırılan toplam test sayısını ve varsa başarısız olan test sayısını yazdırmalıdır. Bu durumda yalnızca bir test çalıştırılmıştır ve bu test başarılı olmuştur.

  9. İkinci bir test eklemek için Test Ekle'yi tekrar tıklayın. "Adsız test 2" olan testin adını "Herkese açık kullanıcı adları tanımlanmadı" olarak değiştirin.

  10. Genişletmek için testi tıklayın ve korumalı alana alınmış JavaScript düzenleyicisini ortaya çıkarın. Düzenleyiciye korumalı alanlı JavaScript girin:

    let variableResult = runCode({});
    assertThat(variableResult).isEqualTo(undefined);
    
  11. Tüm testleri aynı anda çalıştırmak için ▶ Testleri Çalıştır'ı tıklayın. Testin sonucu konsolda gösterilir.

    Herkese açık kullanıcı adları testi başarısız oldu. Tebrikler, bir hata buldunuz!

  12. Geri dönüp şablonun korumalı alana alınmış JavaScript kodunu düzenlemek için Kod'u tıklayın. Korumalı alana alınmış JavaScript'i aşağıdaki gibi güncelleyin:

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

    Güncellenen kod, input değişkenini kullanmadan önce doğrulamayla ilgili en iyi uygulamayı kullanır.

  13. Test durumları listesine dönmek için Testler'i tıklayın.

  14. Tüm test durumlarını tekrar çalıştırmak için ▶ Testleri Çalıştır'ı tıklayın. Herkese açık kullanıcı adları testinin bu kez başarılı olması gerekir.

  15. Kaydet'i tıklayın ve Şablon Düzenleyici'yi kapatın.