Тестирование

Тестирование вашей интеграции

Убедитесь, что ваша интеграция работает корректно, прежде чем переходить в продакшен.

Используйте ваш публичный ключ

Зарегистрируйтесь на бесплатном тарифе и получите ваш публичный ключ из дашборда в разделе 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, который вы можете проверить.