Testing

Menguji Integrasi Anda

Verifikasi bahwa integrasi Anda bekerja dengan benar sebelum masuk ke produksi.

Gunakan public key Anda

Daftar untuk paket gratis dan ambil public key Anda dari dashboard di bagian API Keys — key ini langsung berfungsi dan aman untuk dikirim dalam kode sisi klien. Gunakan untuk pengembangan dan pengujian lokal. Berikan ke 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)

Jika Anda memuat agent melalui edge snippet tanpa build, key yang sama berfungsi di parameter query k:

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

Verifikasi cepat di browser

Jalankan ini di konsol browser pada halaman tempat SDK dimuat untuk memastikan SDK berhasil diinisialisasi dan mengembalikan hasil:

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

Dalam unit test Anda biasanya tidak menginginkan panggilan jaringan yang sebenarnya. Mock modul Tracio dan pastikan kode Anda mengonsumsi getResult() dengan benar. Dengan 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)
})

Anda juga dapat menguji penanganan error dengan membuat getResult() yang telah di-mock melakukan reject dengan sebuah TracioError.

Verifikasi Sisi Server

Untuk bertindak atas hasil identifikasi di server Anda sendiri, terimalah hasil tersebut sebagai webhook yang ditandatangani — setiap event dikirim ke endpoint Anda dengan HMAC X-Tracio-Signature yang dapat Anda verifikasi.