Testare

Testarea integrării

Verificați că integrarea funcționează corect înainte de a trece în producție.

Folosiți cheia publică

Înregistrați-vă pentru planul gratuit și preluați-vă cheia publică din dashboard, la secțiunea API Keys — funcționează imediat și poate fi inclusă în siguranță în codul din partea de client. Folosiți-o pentru dezvoltare și testare locală. Transmiteți-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ă încărcați 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

Rulați 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 doriți un apel de rețea real. Mockați modulul Tracio și verificați că codul dvs. 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, puteț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, primiți-l ca webhook semnat — fiecare eveniment este livrat către endpoint-ul dvs. cu un HMAC X-Tracio-Signature pe care îl puteți verifica.