Тестування

Тестування вашої інтеграції

Переконайтеся, що ваша інтеграція працює коректно, перш ніж переходити до продакшену.

Використовуйте свій публічний ключ

Зареєструйтеся на безкоштовному тарифі та візьміть свій публічний ключ із дашборду в розділі API Keys — він працює одразу й безпечний для використання в клієнтському коді. Використовуйте його для локальної розробки та тестування. Передайте його в Tracio.init():

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)

Якщо ви завантажуєте агент через edge-сніпет без збірки, той самий ключ працює у query-параметрі k:

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

Швидка верифікація у браузері

Виконайте це в консолі браузера на сторінці, де завантажено SDK, щоб підтвердити, що він ініціалізується та повертає результат:

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)

Юніт-тестування

У юніт-тестах ви зазвичай не хочете виконувати реальний мережевий виклик. Замокайте модуль Tracio і переконайтеся, що ваш код коректно споживає getResult(). За допомогою Vitest:

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)
})

Ви також можете перевірити обробку помилок, змусивши замокану getResult() відхилитися з TracioError.

Верифікація на стороні сервера

Щоб відреагувати на результат ідентифікації на власному сервері, отримайте його як підписаний webhook — кожна подія доставляється на ваш endpoint з HMAC-підписом X-Tracio-Signature, який ви можете верифікувати.