Testing

Entegrasyonunuzu Test Etme

Üretime geçmeden önce entegrasyonunuzun doğru çalıştığını doğrulayın.

Genel anahtarınızı kullanın

Ücretsiz plana kaydolun ve genel anahtarınızı dashboard'da API Keys bölümünden alın — anında çalışır ve istemci tarafı kodda güvenle yayınlanabilir. Bunu yerel geliştirme ve test için kullanın. Tracio.init() fonksiyonuna geçirin:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({ publicKey: "YOUR_PUBLIC_KEY" })
const result = await tracio.getResult()
console.log(result.visitorId, result.bot.detected)

Agent'ı derleme gerektirmeyen edge snippet'i üzerinden yüklerseniz, aynı anahtar k sorgu parametresinde çalışır:

<script src="https://edge.tracio.ai/s.js?k=YOUR_PUBLIC_KEY" async></script>

Hızlı tarayıcı doğrulaması

SDK'nın yüklü olduğu bir sayfanın tarayıcı konsolunda, SDK'nın başlatıldığını ve bir sonuç döndürdüğünü doğrulamak için bunu çalıştırın:

import { Tracio } from "@tracio/sdk"

const tracio = Tracio.init({ publicKey: "YOUR_PUBLIC_KEY" })
const result = await tracio.getResult()
console.assert(typeof result.visitorId === "string", "visitorId should be a string")
console.assert(typeof result.bot.detected === "boolean", "bot.detected should be a boolean")
console.log("Integration verified:", result.visitorId)

Birim testi

Birim testlerinde genellikle gerçek bir ağ çağrısı istemezsiniz. Tracio modülünü mock'layın ve kodunuzun getResult() sonucunu doğru şekilde işlediğini doğrulayın. Vitest ile:

import { vi, test, expect } from "vitest"
import { Tracio } from "@tracio/sdk"

vi.mock("@tracio/sdk", () => ({
  Tracio: {
    init: () => ({
      getResult: async () => ({
        visitorId: "test-visitor-id",
        bot: { detected: false, confidence: 0 },
      }),
    }),
  },
}))

test("renders the visitor id", async () => {
  const tracio = Tracio.init({ publicKey: "YOUR_PUBLIC_KEY" })
  const result = await tracio.getResult()
  expect(result.visitorId).toBe("test-visitor-id")
  expect(result.bot.detected).toBe(false)
})

Ayrıca, mock'lanan getResult() fonksiyonunu bir TracioError ile reddettirerek hata işlemeyi de doğrulayabilirsiniz.

Sunucu Tarafı Doğrulama

Bir kimlik tanımlama sonucuna kendi sunucunuzda tepki vermek için, sonucu imzalı bir webhook olarak alın — her olay, uç noktanıza doğrulayabileceğiniz bir X-Tracio-Signature HMAC ile teslim edilir.