Testing

Je integratie testen

Controleer of je integratie correct werkt voordat je naar productie gaat.

Gebruik je publieke sleutel

Meld je aan voor het Free-plan en haal je publieke sleutel op uit het dashboard onder API Keys — hij werkt meteen en kan veilig worden meegeleverd in clientside code. Gebruik hem voor lokale ontwikkeling en tests. Geef hem door aan 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)

Als je de agent laadt via het build-vrije edge-snippet, werkt dezelfde sleutel in de queryparameter k:

HTML

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

Snelle browserverificatie

Voer dit uit in de browserconsole van een pagina waarop de SDK is geladen om te bevestigen dat hij initialiseert en een resultaat teruggeeft:

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)

Unittests

In unittests wil je meestal geen echte netwerkaanroep. Mock de Tracio-module en controleer dat je code getResult() correct verwerkt. Met 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)
})

Je kunt ook de foutafhandeling controleren door de gemockte getResult() te laten falen met een TracioError.

Serverside verificatie

Om op je eigen server op een identificatieresultaat te reageren, ontvang je het als een ondertekende webhook — elke gebeurtenis wordt aan je endpoint geleverd met een X-Tracio-Signature-HMAC die je kunt verifiëren.

Je integratie testen

Controleer of je integratie correct werkt voordat je naar productie gaat.

Gebruik je publieke sleutel

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)

Als je de agent laadt via het build-vrije edge-snippet, werkt dezelfde sleutel in de queryparameter k:

HTML

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

Snelle browserverificatie

Voer dit uit in de browserconsole van een pagina waarop de SDK is geladen om te bevestigen dat hij initialiseert en een resultaat teruggeeft:

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)

Unittests

In unittests wil je meestal geen echte netwerkaanroep. Mock de Tracio-module en controleer dat je code getResult() correct verwerkt. Met 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)
})

Je kunt ook de foutafhandeling controleren door de gemockte getResult() te laten falen met een TracioError.

Serverside verificatie