Testing

Testowanie integracji

Sprawdź, czy Twoja integracja działa poprawnie, zanim wdrożysz ją na produkcję.

Użyj swojego klucza publicznego

Zarejestruj się w planie darmowym i pobierz swój klucz publiczny z panelu w sekcji API Keys — działa od razu i można go bezpiecznie umieścić w kodzie po stronie klienta. Używaj go do lokalnego programowania i testowania. Przekaż go do 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)

Jeśli ładujesz agenta za pomocą bezbuildowego snippetu edge, ten sam klucz działa w parametrze zapytania k:

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

Szybka weryfikacja w przeglądarce

Uruchom to w konsoli przeglądarki na stronie, na której załadowane jest SDK, aby potwierdzić, że się inicjalizuje i zwraca wynik:

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)

Testy jednostkowe

W testach jednostkowych zwykle nie chcesz wykonywać rzeczywistego wywołania sieciowego. Zamockuj moduł Tracio i sprawdź, że Twój kod poprawnie korzysta z getResult(). Z 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)
})

Możesz też sprawdzić obsługę błędów, sprawiając, że zamockowane getResult() zostanie odrzucone z błędem TracioError.

Weryfikacja po stronie serwera

Aby zareagować na wynik identyfikacji na własnym serwerze, odbierz go jako podpisany webhook — każde zdarzenie jest dostarczane do Twojego endpointu z sygnaturą HMAC X-Tracio-Signature, którą możesz zweryfikować.