@arms/rum-core 0.1.6 → 0.1.8

package/lib/utils/base.js

@@ -11,6 +11,7 @@ exports.interceptFunction = interceptFunction;
 exports.parseRegExpString = parseRegExpString;
 exports.restoreFunction = restoreFunction;
 var _is = require("./is");
+var _logger = require("../monitor/logger");
 /**
  * 劫持函数或原型
  */
@@ -18,19 +19,74 @@ function interceptFunction(target, name, callback, isPrototype) {
   if (isPrototype === void 0) {
     isPrototype = false;
   }
-  var registeredMethod = target[name];
-  var proxyMethod = function proxyMethod() {
-    var ctx = isPrototype ? this : target;
-    for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
-      args[_key] = arguments[_key];
+  try {
+    var registeredMethod = target[name];
+    var proxyMethod = function proxyMethod() {
+      var ctx = isPrototype ? this : target;
+      for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
+        args[_key] = arguments[_key];
+      }
+      try {
+        // callback 异常隔离：SDK 采集逻辑出错不能中断客户原函数执行
+        callback.apply(ctx, args);
+      } catch (e) {
+        _logger.logger.warn('interceptFunction', "callback error in \"" + name + "\"", e);
+      }
+      if ((0, _is.isFunction)(registeredMethod)) {
+        return registeredMethod.apply(ctx, args);
+      }
+    };
+    disguiseProxy(proxyMethod, registeredMethod);
+    target[name] = proxyMethod;
+  } catch (e) {
+    // 劫持安装保护：target 属性只读 accessor 或被 freeze 时（strict mode 下抛 TypeError），
+    // 上报后静默返回，不中断 SDK 初始化
+    _logger.logger.warn('interceptFunction', "install proxy failed for \"" + name + "\"", e);
+  }
+}
+
+/**
+ * 伪装代理函数，降低劫持对客户代码的感知：
+ * 1. toString 返回原函数源码（String()、模板字符串、console.log、日志序列化等路径可见原函数）
+ * 2. name/length 与原函数对齐
+ * 3. _rum_intercepted 不可枚举，避免污染 Object.keys / for...in
+ * 注意：defineProperty 在部分小程序运行时可能失败，需降级为直接挂载，不能中断劫持主流程
+ *
+ */
+function disguiseProxy(proxyMethod, originalMethod) {
+  try {
+    if ((0, _is.isFunction)(originalMethod)) {
+      Object.defineProperty(proxyMethod, 'toString', {
+        value: function value() {
+          return originalMethod.toString();
+        },
+        writable: true,
+        configurable: true
+      });
+      Object.defineProperty(proxyMethod, 'name', {
+        value: originalMethod.name,
+        configurable: true
+      });
+      Object.defineProperty(proxyMethod, 'length', {
+        value: originalMethod.length,
+        configurable: true
+      });
     }
-    callback.apply(ctx, args);
-    if ((0, _is.isFunction)(registeredMethod)) {
-      return registeredMethod.apply(ctx, args);
+    Object.defineProperty(proxyMethod, '_rum_intercepted', {
+      value: originalMethod,
+      enumerable: false,
+      writable: true,
+      configurable: true
+    });
+  } catch (e) {
+    // 降级：defineProperty 不可用时直接挂载，保证 restoreFunction 仍可用
+    try {
+      proxyMethod._rum_intercepted = originalMethod;
+    } catch (err) {
+      // 二层保护：strict mode 下对不可扩展对象直接赋值也会抛 TypeError，上报后放弃挂载
+      _logger.logger.warn('interceptFunction', 'disguiseProxy fallback failed', err);
     }
-  };
-  proxyMethod._rum_intercepted = registeredMethod;
-  target[name] = proxyMethod;
+  }
 }
 
 /**
@@ -158,72 +214,6 @@ function delay(func, wait) {
   return setTimeout.apply(void 0, [func, +wait || 0].concat(args));
 }
 
-// // 类型匹配正则
-// const TYPE_REG = /^\[object ([a-z]*)\]$/;
-// /**
-//  * @desc 需要严格区分object和array
-//  * @param obj 任意对象
-//  */
-// export function getType(obj: any) {
-//   let type = Object.prototype.toString.call(obj);
-//   type = type.toLowerCase() || '';
-//   const arr = type.match(TYPE_REG);
-//   return arr?.[1];
-// }
-//
-// /**
-//  * @desc 将字符串转换成正则表达式
-//  * @param str 任意字符串
-//  * 注意，这里只支持 /xxx/ 这种格式，不支持修饰符，例如 /xxx/ig
-//  */
-// export function transStrToReg(str: string) {
-//   if (getType(str) !== 'string') return str;
-//   if (str.length > 2 && str[0] === '/' && str[str.length - 1] === '/') {
-//     return new RegExp(str.substr(1, str.length - 2));
-//   }
-//   return str;
-// }
-//
-// /**
-//  *
-//  * @param config 配置
-//  * @param keys 需要转换的字段
-//  */
-// export function toRegFormat(config: any, keys: any[]) {
-//   if (getType(keys) === 'string') {
-//     keys = [keys];
-//   }
-//   for (let i = 0, len = keys.length; i < len; i++) {
-//     const paths = keys[i].split('.');
-//     const lastIndex = paths.length - 1;
-//     if (!config) break;
-//     let tmp = config;
-//     for (let j = 0, jlen = paths.length; j < jlen; j++) {
-//       if (paths[j] === '[]') {
-//         if (getType(tmp) === 'array') {
-//           let lastPath = paths.splice(j + 1);
-//           lastPath = lastPath.join('.');
-//           for (let x = 0, xlen = tmp.length; x < xlen; x++) {
-//             toRegFormat(tmp[x], lastPath);
-//           }
-//         }
-//         break;
-//       }
-//       // 最后一层了，需要往前一层才能修改对象
-//       if (lastIndex === j && getType(tmp[paths[j]]) === 'string') {
-//         tmp[paths[j]] = transStrToReg(tmp[paths[j]]);
-//         break;
-//       }
-//       tmp = tmp[paths[j]];
-//       if (!tmp) break;
-//     }
-//     if (!tmp || getType(tmp) !== 'array') continue;
-//     for (let j = 0, jlen = tmp.length; j < jlen; j++) {
-//       tmp[j] = transStrToReg(tmp[j]);
-//     }
-//   }
-// }
-
 /**
  * 解析正则表达式字符串，支持 /pattern/flags 格式
  * @param str 正则表达式字符串，如 "/a/ig" 或 "a"

package/lib/utils/disposable.d.ts

@@ -0,0 +1,12 @@
+/**
+ * 资源清理组：统一管理多个清理函数的生命周期
+ *
+ * 用于收敛采集器中常见的 cleanup 数组模式，
+ * 避免每个采集器重复实现 push + forEach 逻辑
+ */
+export declare function createDisposableGroup(): {
+    /** 注册一个或多个清理函数 */
+    add(...fns: Array<() => void>): void;
+    /** 执行所有清理函数并重置 */
+    dispose(): void;
+};

package/lib/utils/disposable.js

@@ -0,0 +1,24 @@
+"use strict";
+
+exports.__esModule = true;
+exports.createDisposableGroup = createDisposableGroup;
+/**
+ * 资源清理组：统一管理多个清理函数的生命周期
+ *
+ * 用于收敛采集器中常见的 cleanup 数组模式，
+ * 避免每个采集器重复实现 push + forEach 逻辑
+ */
+function createDisposableGroup() {
+  var cleanups = [];
+  return {
+    /** 注册一个或多个清理函数 */add: function add() {
+      cleanups.push.apply(cleanups, arguments);
+    },
+    /** 执行所有清理函数并重置 */dispose: function dispose() {
+      cleanups.forEach(function (fn) {
+        return fn();
+      });
+      cleanups.length = 0;
+    }
+  };
+}

package/lib/utils/throttle.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 带 cancel 的 leading + trailing 节流函数
+ *
+ * - leading：连续调用时立即触发首次
+ * - trailing：保证最后一次在 wait 内补发
+ * - cancel：丢弃尾调用并重置节流窗口，防止跨 view 串数据
+ *
+ * @param fn 需要节流的函数
+ * @param wait 节流间隔（毫秒）
+ */
+export declare function throttle(fn: () => void, wait: number): {
+    (): void;
+    cancel: () => void;
+};

package/lib/utils/throttle.js

@@ -0,0 +1,44 @@
+"use strict";
+
+exports.__esModule = true;
+exports.throttle = throttle;
+/**
+ * 带 cancel 的 leading + trailing 节流函数
+ *
+ * - leading：连续调用时立即触发首次
+ * - trailing：保证最后一次在 wait 内补发
+ * - cancel：丢弃尾调用并重置节流窗口，防止跨 view 串数据
+ *
+ * @param fn 需要节流的函数
+ * @param wait 节流间隔（毫秒）
+ */
+function throttle(fn, wait) {
+  var lastInvoke = 0;
+  var timer = null;
+  var invoke = function invoke() {
+    lastInvoke = Date.now();
+    timer = null;
+    fn();
+  };
+  var wrapped = function wrapped() {
+    var remaining = wait - (Date.now() - lastInvoke);
+    if (remaining <= 0) {
+      if (timer) {
+        clearTimeout(timer);
+        timer = null;
+      }
+      invoke();
+    } else if (!timer) {
+      timer = setTimeout(invoke, remaining);
+    }
+  };
+  wrapped.cancel = function () {
+    if (timer) {
+      clearTimeout(timer);
+      timer = null;
+    }
+    // 重置 leading 窗口，让下次调用立刻触发，避免跨 view 共享上次的节流窗口
+    lastInvoke = 0;
+  };
+  return wrapped;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arms/rum-core",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "description": "arms rum javascript sdk core",
   "author": "guangli.fj <guangli.fj@alibaba-inc.com>",
   "license": "ISC",