JavaScript类中统一异常捕获需包装方法而非包裹类体，核心方案有：①装饰器自动包装（推荐，需环境支持）；②基类封装+模板方法（兼容性最好）；③Proxy拦截实例方法（不改源码）；④约定+工具函数（轻量灵活）。
在 JavaScript class 中无法像 Java 那样直接用 try/catch 包裹整个类体来统一捕获异常，因为类本身不执行逻辑，真正运行的是方法（函数）。所以“统一异常捕获日志”的核心思路是：**对类中所有可能抛出异常的方法进行包装，集中处理错误并记录日志**。
用装饰器（Decorator）自动包装方法（推荐，需环境支持）
如果你使用 TypeScript 或支持装饰器提案的现代 JS 环境（如 Babel + @babel/plugin-proposal-decorators），可以定义一个日志装饰器：
- 装饰器在方法调用前/后注入逻辑，无需修改每个方法内部
- 统一捕获同步和
async方法中的异常（await后的错误可被try/catch捕获） - 示例：
function withErrorLog(target, key, descriptor) {
const original = descriptor.value;
descriptor.value = async function (...args) {
try {
return await original.apply(this, args);
} catch (err) {
console.error(`[Error in ${key}]:`, err.message);
console.error('Stack:', err.stack);
// 这里可发送到 Sentry、上报接口、写入 localStorage 等
throw err; // 选择是否继续抛出
}
};
return descriptor;
}
class ApiService {
@withErrorLog
async fetchUser(id) {
const res = await fetch(`/api/user/${id}`);
if (!res.ok) throw new Error(`HTTP ${res.status}`);
return res.json();
}
@withErrorLog
processData(data) {
if (!data) throw new TypeError('data is required');
return data.map(x => x.toUpperCase());
}
}
基类封装 + 模板方法模式（兼容性最好）
适用于不支持装饰器的环境（如纯浏览器原生 JS）。让业务类继承一个带错误处理能力的基类：
- 定义
safeRun方法，接收实际逻辑函数，统一包裹try/catch - 子类通过重写
doXXX方法实现具体逻辑，避免重复写try/catch - 示例：
class SafeClass {
safeRun(fn, ...args) {
try {
return fn.call(this, ...args);
} catch (err) {
this.logError(err, fn.name);
throw err;
}
}
logError(err, methodName) {
console.warn(`[${this.constructor.name}.${methodName}]`, err.message);
// 可扩展：时间戳、用户 ID、URL 等上下文
}
}
class UserManager extends SafeClass {
getUser(id) {
return this.safeRun(this.doGetUser, id);
}
doGetUser(id) {
if (!id) throw new Error('ID is required');
return { id, name: 'Alice' };
}
}
代理（Proxy）拦截方法调用（适合已有类，不改源码）
如果不能修改原始类定义（比如第三方库类），可用 Proxy 在实例层面做方法调用拦截：
立即学习“Java免费学习笔记（深入）”；
- 对目标实例的所有函数属性自动加一层错误捕获
- 注意：仅对可枚举、自身拥有的方法生效；静态方法、原型链方法需额外处理
- 示例：
function createLoggedInstance(instance) {
return new Proxy(instance, {
get(target, prop) {
const value = target[prop];
if (typeof value === 'function' && prop !== 'constructor') {
return function (...args) {
try {
return value.apply(target, args);
} catch (err) {
console.error(`[Proxy Error in ${prop}]:`, err);
throw err;
}
};
}
return value;
}
});
}
const api = createLoggedInstance(new ApiService());
api.fetchUser(123); // 出错时自动记录
约定 + 工具函数辅助（轻量灵活）
不依赖语法特性，靠团队约定和小工具降低重复成本：
- 定义一个
logAndThrow工具函数，在关键方法末尾或入口手动包裹 - 配合 ESLint 规则提醒未处理的潜在异常点（如未 await 的 Promise）
- 适合渐进式改造或小型项目
const logAndThrow = (opName, fn) => (...args) => {
try {
return fn(...args);
} catch (err) {
console.error(`❌ ${opName}:`, err);
throw err;
}
};
class Calculator {
add = logAndThrow('add', (a, b) => {
if (typeof a !== 'number') throw new TypeError('a must be number');
return a + b;
});
}
