Tests

Tester votre intégration

Vérifiez que votre intégration fonctionne correctement avant la mise en production.

Utilisez votre clé publique

Inscrivez-vous à l'offre gratuite et récupérez votre clé publique depuis le tableau de bord, sous API Keys — elle fonctionne immédiatement et peut être livrée en toute sécurité dans le code côté client. Utilisez-la pour le développement local et les tests. Passez-la à 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)

Si vous chargez l'agent via le snippet edge sans build, la même clé fonctionne dans le paramètre de requête k :

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

Vérification rapide dans le navigateur

Exécutez ceci dans la console du navigateur d'une page où le SDK est chargé pour confirmer qu'il s'initialise et renvoie un résultat :

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)

Tests unitaires

Dans les tests unitaires, vous ne voulez généralement pas d'un véritable appel réseau. Mockez le module Tracio et vérifiez que votre code consomme correctement getResult(). Avec 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)
})

Vous pouvez également vérifier la gestion des erreurs en faisant en sorte que le getResult() mocké rejette avec une TracioError.

Vérification côté serveur

Pour agir sur un résultat d'identification sur votre propre serveur, recevez-le sous forme de webhook signé — chaque événement est livré à votre endpoint avec un HMAC X-Tracio-Signature que vous pouvez vérifier.