decimal.js 安全扩展实践：继承及修复构造函数劫持问题

本文详解如何正确继承 decimal.js 的 decimal 类，解决其内部强制重置 constructor 导致的子类方法调用失效问题，并提供可落地的安全输入封装方案。

本文详解如何正确继承 decimal.js 的 decimal 类，解决其内部强制重置 constructor 导致的子类方法调用失效问题，并提供可落地的安全输入封装方案。

在金融、计费、科学计算等对精度与健壮性要求极高的场景中，直接使用 decimal.js 的 Decimal 类虽能规避 JavaScript 原生浮点误差，但其原始设计存在一个关键限制：每个实例的 constructor 属性被硬编码为 Decimal 本身（见源码 decimal.mjs 第 4290 行 x.constructor = Decimal）。这一设计初衷是避免继承链中 constructor 指向 Object，却意外破坏了标准的原型继承语义——导致子类方法中通过 new this.constructor(...) 创建新实例时，实际调用的仍是父类 Decimal 构造函数，而非子类自定义逻辑。

这意味着，即使你精心封装了输入校验逻辑：

import { Decimal } from 'decimal.js';class SafeDecimal extends Decimal {  constructor(value: Decimal.Value) {    // ❌ 错误示范：未修复 constructor 劫持    if (typeof value === 'string' && !/^-?d*.?d+(?:[eE][+-]?d+)?$/.test(value)) {      super('NaN');    } else {      super(value);    }  }}

当执行 new SafeDecimal('1.5').add('invalid') 时，add 方法内部会调用 new this.constructor('invalid') —— 此时 this.constructor 已被 decimal.js 覆盖为 Decimal，于是跳过你的校验逻辑，直接触发原生 Decimal('invalid') 报错（DecimalError），而非预期的 NaN 结果。

✅ 正确解法：在子类构造函数末尾显式恢复 constructor 引用：

import { Decimal } from 'decimal.js';class SafeDecimal extends Decimal {  constructor(value: Decimal.Value) {    // ✅ 输入预处理：严格校验字符串格式    const sanitized = typeof value === 'string'      ? (/^-?d*.?d+(?:[eE][+-]?d+)?$/.test(value) ? value : 'NaN')      : value;    super(sanitized);    // ✅ 关键修复：覆盖 decimal.js 的 constructor 劫持    this.constructor = SafeDecimal;  }  // 可选：增强型静态工厂方法（更语义化）  static from(value: unknown): SafeDecimal {    try {      return new SafeDecimal(value);    } catch {      return new SafeDecimal('NaN');    }  }}// ✅ 验证：方法链式调用 now respects sanitizationconsole.log(new SafeDecimal('1.5').add('abc').toString()); // "NaN"console.log(new SafeDecimal('2').times('3').toString());   // "6"console.log(new SafeDecimal('invalid').toString());        // "NaN"

⚠️ 注意事项：

• this.constructor = SafeDecimal 必须置于 super() 调用之后，否则 this 尚未初始化；
• 此修复仅针对 decimal.js 特定实现，属「兼容性补丁」，非通用继承模式；
• 字符串校验建议采用正则 /^-?d*.?d+(?:[eE][+-]?d+)?$/ 替代 parseFloat()，后者对 '123abc' 返回 123，存在静默错误风险；
• 若项目长期依赖此类安全封装，推荐 Fork decimal.js 并移除 x.constructor = Decimal 行，从源头消除该设计副作用。

最终，SafeDecimal 不仅保留了 Decimal 全套高精度运算能力（.plus(), .dividedBy(), .sqrt() 等），更确保所有方法内部新建实例均经过统一输入治理，真正实现「一处校验、处处生效」的安全计算闭环。