User Behavior Analysis - TypeScript 版本

一个用于追踪和记录用户在网页上各种交互行为的 TypeScript 库。

🚀 快速开始

安装

npm install user-behavior-analysis

基础使用

importuserBehaviourfrom'user-behavior-analysis';// 配置并开始追踪userBehaviour.config({clicks: true,mouseMovement: true,keyboardActivity: true,processData: (results)=>{console.log('用户行为数据:',results);}});userBehaviour.start();

✨ 功能特性

• 🖱️ 鼠标行为追踪 - 移动轨迹、点击位置、滚动行为
• ⌨️ 键盘活动监控 - 按键记录、输入行为分析
• 📱 触摸事件支持 - 移动设备触摸交互
• 📝 表单交互追踪 - 表单提交、输入行为
• 🎵 媒体交互监控 - 音视频播放行为
• 🔄 页面状态监控 - 窗口大小、页面可见性、导航历史
• ⚡ 实时数据处理 - 可配置的数据处理间隔
• 🌐 自动数据发送 - 支持后台服务器数据推送
• 🛡️ 隐私保护 - 可配置的数据收集范围
• 📊 类型安全 - 完整的 TypeScript 类型定义

📚 API 参考

核心方法

// 配置选项userBehaviour.config(options);// 开始/停止追踪userBehaviour.start();userBehaviour.stop();// 获取结果constresults=userBehaviour.showResult();// 注册自定义事件userBehaviour.registerCustomEvent('eventName',callback);

🌐 浏览器支持

• Chrome 60+
• Firefox 55+
• Safari 12+
• Edge 79+
• 移动端浏览器

📄 许可证

MIT License - 查看 LICENSE 文件了解详情。

📖 详细文档

查看 DOCUMENTATION.md 获取完整的使用指南、配置选项、API参考和示例代码。

开始使用 User Behavior Analysis 库，深入了解您的用户行为！ 🚀