Testing

Ihre Integration testen

Überprüfen Sie, ob Ihre Integration korrekt funktioniert, bevor Sie in Produktion gehen.

Verwenden Sie Ihren öffentlichen Schlüssel

Registrieren Sie sich für den Free-Tarif und holen Sie sich Ihren öffentlichen Schlüssel aus dem Dashboard unter API Keys — er funktioniert sofort und kann gefahrlos in clientseitigem Code ausgeliefert werden. Verwenden Sie ihn für lokale Entwicklung und Tests. Übergeben Sie ihn an 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)

Wenn Sie den Agenten über das buildfreie Edge-Snippet laden, funktioniert derselbe Schlüssel im Query-Parameter k:

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

Schnelle Browser-Verifizierung

Führen Sie dies in der Browser-Konsole einer Seite aus, auf der das SDK geladen ist, um zu bestätigen, dass es initialisiert und ein Ergebnis zurückgibt:

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-Testing

In Unit-Tests wollen Sie in der Regel keinen echten Netzwerkaufruf. Mocken Sie das Tracio-Modul und stellen Sie sicher, dass Ihr Code getResult() korrekt verarbeitet. Mit 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)
})

Sie können die Fehlerbehandlung auch prüfen, indem Sie das gemockte getResult() mit einem TracioError ablehnen lassen.

Serverseitige Verifizierung

Um auf ein Identifikationsergebnis auf Ihrem eigenen Server zu reagieren, empfangen Sie es als signierten Webhook — jedes Ereignis wird mit einem HMAC X-Tracio-Signature an Ihren Endpunkt geliefert, den Sie verifizieren können.