Test

Testare l'integrazione

Verifichi che la sua integrazione funzioni correttamente prima di passare in produzione.

Usi la sua public key

Si registri al piano gratuito e prenda la sua public key dalla dashboard, sotto API Keys — funziona immediatamente ed è sicura da distribuire nel codice client-side. La usi per lo sviluppo e i test in locale. La passi a 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)

Se carica l'agente tramite lo snippet edge zero-build, la stessa key funziona nel parametro di query k:

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

Verifica rapida nel browser

Esegua questo nella console del browser su una pagina in cui l'SDK è caricato per confermare che si inizializzi e restituisca un risultato:

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 test

Negli unit test di solito non si desidera una vera chiamata di rete. Faccia il mock del modulo Tracio e verifichi che il suo codice consumi getResult() correttamente. Con 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)
})

Può anche verificare la gestione degli errori facendo sì che il getResult() mockato venga rifiutato con un TracioError.

Verifica server-side

Per agire su un risultato di identificazione sul suo server, lo riceva come webhook firmato — ogni evento viene recapitato al suo endpoint con un HMAC X-Tracio-Signature che può verificare.