Testning

Testa din integration

Verifiera att din integration fungerar korrekt innan du går i produktion.

Använd din publika nyckel

Registrera dig för Free-planen och hämta din publika nyckel från din dashboard under API Keys — den fungerar direkt och kan tryggt levereras i klientkod. Använd den för lokal utveckling och testning. Skicka den till 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)

Om du laddar agenten via det byggfria edge-snippet fungerar samma nyckel i query-parametern k:

HTML

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

Snabb verifiering i webbläsaren

Kör detta i webbläsarkonsolen på en sida där SDK:et är laddat för att bekräfta att det initieras och returnerar ett resultat:

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)

Enhetstestning

I enhetstester vill du vanligtvis inte göra ett riktigt nätverksanrop. Mocka Tracio-modulen och verifiera att din kod använder getResult() korrekt. Med 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)
})

Du kan även verifiera felhantering genom att låta den mockade getResult() avvisas med ett TracioError.

Serverbaserad verifiering

För att agera på ett identifieringsresultat på din egen server tar du emot det som en signerad webhook — varje händelse levereras till din endpoint med en X-Tracio-Signature-HMAC som du kan verifiera.

Testa din integration

Verifiera att din integration fungerar korrekt innan du går i produktion.

Använd din publika nyckel

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)

Om du laddar agenten via det byggfria edge-snippet fungerar samma nyckel i query-parametern k:

HTML

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

Snabb verifiering i webbläsaren

Kör detta i webbläsarkonsolen på en sida där SDK:et är laddat för att bekräfta att det initieras och returnerar ett resultat:

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)

Enhetstestning

I enhetstester vill du vanligtvis inte göra ett riktigt nätverksanrop. Mocka Tracio-modulen och verifiera att din kod använder getResult() korrekt. Med 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)
})

Du kan även verifiera felhantering genom att låta den mockade getResult() avvisas med ett TracioError.

Serverbaserad verifiering