Trackjs-sdk

Automatic user behavior tracking SDK for React applications, capturing clicks, form submissions, and input changes via document-level event delegation—no in-component modifications required.

Table of Contents

• Features
• Installation
• Usage

Features

• Zero-config instrumentation via document-level event delegation—no boilerplate in React components.
• Automatic batching of events with configurable batch size and interval.
• Reliable delivery using navigator.sendBeacon() with fetch(..., { keepalive: true }) fallback for unload scenarios.
• Input sanitization & masking to strip HTML and redact sensitive fields (e.g., passwords).
• GDPR & DNT compliance with an opt-out API (disableTracker()).

Installation

Install via npm:

npm install trackjs-sdk

Usage

import { initTracker } from "trackjs-sdk";

initTracker({
  endpoint: "https://api.yourdomain.com/track",
  apiKey: "YOUR_API_KEY",
  batchSize: 20,
  batchInterval: 5000,
  maskInputs: ["password", "credit-card"],
  enableBeacon: true,
  debug: false,
});