Testování

Testování vaší integrace

Ověřte, že vaše integrace funguje správně, než přejdete do produkce.

Použijte svůj veřejný klíč

Zaregistrujte se do bezplatného tarifu a získejte svůj veřejný klíč z dashboardu v sekci API Keys — funguje okamžitě a lze jej bezpečně nasadit do kódu na straně klienta. Použijte jej pro lokální vývoj a testování. Předejte jej do Tracio.init():

TypeScript

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)

Pokud agenta načítáte přes edge snippet bez buildu, stejný klíč funguje v query parametru k:

HTML

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

Rychlé ověření v prohlížeči

Spusťte toto v konzoli prohlížeče na stránce, kde je SDK načteno, abyste potvrdili, že se inicializuje a vrací výsledek:

TypeScript

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)

Unit testování

V unit testech obvykle nechcete skutečné síťové volání. Namockujte modul Tracio a ověřte, že váš kód správně zpracovává getResult(). S nástrojem Vitest:

TypeScript

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

Chování při chybách můžete ověřit také tak, že namockovaný getResult() necháte skončit odmítnutím s chybou TracioError.

Ověření na straně serveru

Chcete-li reagovat na výsledek identifikace na vlastním serveru, přijměte jej jako podepsaný webhook — každá událost je doručena na váš endpoint s HMAC X-Tracio-Signature, který si můžete ověřit.

Testování vaší integrace

Ověřte, že vaše integrace funguje správně, než přejdete do produkce.

Použijte svůj veřejný klíč

TypeScript

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)

Pokud agenta načítáte přes edge snippet bez buildu, stejný klíč funguje v query parametru k:

HTML

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

Rychlé ověření v prohlížeči

Spusťte toto v konzoli prohlížeče na stránce, kde je SDK načteno, abyste potvrdili, že se inicializuje a vrací výsledek:

TypeScript

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)

Unit testování

V unit testech obvykle nechcete skutečné síťové volání. Namockujte modul Tracio a ověřte, že váš kód správně zpracovává getResult(). S nástrojem Vitest:

TypeScript

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

Chování při chybách můžete ověřit také tak, že namockovaný getResult() necháte skončit odmítnutím s chybou TracioError.

Ověření na straně serveru