@fle-sdk/event-tracking-web 1.2.1 → 1.2.2

package/lib/types/index.d.ts

@@ -17,6 +17,11 @@ declare class WebTracking extends Tools {
     private batchTimer;
     private readonly BATCH_QUEUE_STORAGE_KEY;
     private useCustomPageKey;
+    private pendingRequests;
+    private isUnloadListenerSetup;
+    private readonly PENDING_REQUESTS_STORAGE_KEY;
+    private readonly DEFAULT_PENDING_REQUESTS_MAX_SIZE;
+    private readonly MAX_STORAGE_SIZE;
     constructor();
     protected userInfo?: JsonProps;
     protected currentUrl: string;
@@ -116,14 +121,45 @@ declare class WebTracking extends Tools {
      * 从 LocalStorage 恢复批量队列
      */
     private restoreBatchQueueFromStorage;
+    /**
+     * 添加到待发送请求队列
+     * @param params 数据参数
+     */
+    private addToPendingRequests;
+    /**
+     * 从 LocalStorage 恢复待发送请求
+     */
+    private restorePendingRequestsFromStorage;
+    /**
+     * 检查页面是否即将卸载
+     * @returns 如果页面即将卸载返回 true，否则返回 false
+     */
+    private isPageUnloading;
+    /**
+     * 使用 sendBeacon 发送数据（页面卸载时的备用方案）
+     * @param params 数据参数
+     * @param serverUrl 服务器地址
+     * @param contentType 内容类型
+     * @returns 是否发送成功
+     */
+    private sendWithBeacon;
+    /**
+     * 刷新待发送的单个请求（正常情况下的发送）
+     * 注意：这个方法会直接发送，不会再次添加到 pendingRequests，避免循环
+     */
+    private flushPendingRequests;
     /**
      * 保存批量队列到 LocalStorage
      */
     private saveBatchQueueToStorage;
     /**
-     * 设置页面卸载监听器，保存队列
+     * 设置页面卸载监听器，确保数据发送
      */
     private setupBeforeUnloadListener;
+    /**
+     * 刷新待发送数据（在页面卸载/跳转时调用）
+     */
+    private flushPendingData;
     /**
      * 发送数据通用函数
      */

package/lib/types/type.d.ts

@@ -57,6 +57,11 @@ export interface PresetParams {
      * @default false
      */
     autoTrack?: boolean;
+    /**
+     * @description 是否对带有 data-part-key 属性的元素点击进行上报（即使 autoTrack 为 false）
+     * @default false
+     */
+    trackPartKeyClick?: boolean;
     /**
      * @description （是否使用客户端系统时间）注意：客户端系统时间可能会不准确，导致该字段不准确
      * @default true
@@ -107,6 +112,11 @@ export interface PresetParams {
      * @default 10
      */
     batchMaxSize?: number;
+    /**
+     * @description 待发送请求队列最大数量（防止内存溢出）
+     * @default 50
+     */
+    pendingRequestsMaxSize?: number;
     /**
      * @description 自定义页面唯一标识，如果不传则自动从路由获取
      * @default 自动从 window.location.pathname 获取
@@ -122,6 +132,10 @@ export interface InitParams extends PresetParams {
      * @description 数据接收地址
      */
     serverUrl: string;
+    /**
+     * @description 用户信息，初始化时设置用户信息（可选，也可以通过 login 方法设置）
+     */
+    userInfo?: JsonProps;
 }
 export declare type PlatformType = "h5" | "pc" | "ipad" | "other";
 export interface SystemsInfoTypes {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fle-sdk/event-tracking-web",
-  "version": "1.2.1",
+  "version": "1.2.2",
   "description": "event tracking in web",
   "author": "飞象前端团队",
   "license": "ISC",