Testing

Kiểm thử tích hợp của bạn

Hãy xác minh rằng tích hợp của bạn hoạt động đúng trước khi đưa lên môi trường production.

Sử dụng khóa công khai của bạn

Đăng ký gói miễn phí và lấy khóa công khai của bạn từ dashboard trong mục API Keys — nó hoạt động ngay lập tức và có thể phân phối an toàn trong mã phía client. Hãy dùng nó cho phát triển và kiểm thử cục bộ. Truyền nó vào 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)

Nếu bạn nạp agent qua đoạn snippet edge không cần build, cùng một khóa đó vẫn hoạt động trong tham số truy vấn k:

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

Xác minh nhanh trên trình duyệt

Chạy đoạn mã sau trong console trình duyệt của một trang đã nạp SDK để xác nhận rằng nó khởi tạo và trả về kết quả:

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

Trong unit test, thông thường bạn không muốn có một lệnh gọi mạng thật. Hãy mock module Tracio và kiểm tra rằng mã của bạn sử dụng getResult() một cách chính xác. Với 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)
})

Bạn cũng có thể kiểm tra việc xử lý lỗi bằng cách để getResult() đã được mock reject với một TracioError.

Xác minh phía máy chủ

Để xử lý một kết quả nhận dạng trên máy chủ của riêng bạn, hãy nhận nó dưới dạng webhook đã ký — mỗi sự kiện được gửi đến endpoint của bạn kèm một HMAC X-Tracio-Signature mà bạn có thể xác minh.