Testare

Testarea integrării

Verifică dacă integrarea funcționează corect înainte de a trece în producție.

Folosește cheia publică

Înregistrează-te pentru planul gratuit și preia-ți cheia publică din dashboard, la secțiunea API Keys — funcționează imediat și poate fi inclusă în siguranță în codul din partea de client. Folosește-o pentru dezvoltare și testare locală. Transmite-o către 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)

Dacă încarci agentul prin snippet-ul edge fără build, aceeași cheie funcționează în parametrul de query k:

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

Verificare rapidă în browser

Rulează acest cod în consola browserului pe o pagină unde SDK-ul este încărcat, pentru a confirma că se inițializează și returnează un rezultat:

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)

Testare unitară

În testele unitare, de regulă nu vrei un apel de rețea real. Mockează modulul Tracio și verifică dacă codul tău consumă corect getResult(). Cu 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)
})

De asemenea, poți verifica gestionarea erorilor făcând ca getResult() mockat să respingă cu o eroare TracioError.

Verificare pe partea de server

Pentru a acționa asupra unui rezultat de identificare pe propriul server, primește-l ca webhook semnat — fiecare eveniment este livrat către endpoint-ul tău cu un HMAC X-Tracio-Signature pe care îl poți verifica.