LiquidJS 中的自定义错误处理机制解析

在 LiquidJS 模板引擎开发过程中，错误处理是一个重要但容易被忽视的环节。本文将深入探讨如何在 LiquidJS 中实现优雅的自定义错误处理机制，特别是在开发自定义标签时如何抛出和捕获特定类型的错误。

问题背景

在模板渲染过程中，开发者经常需要实现一些业务逻辑验证。例如，开发一个 assert 标签来验证某些条件是否满足：

{% assert condition=... action=... %}

当条件不满足时，我们需要：

1. 立即停止渲染过程
2. 向调用方传递详细的错误信息
3. 允许调用方识别特定的错误类型

现有方案的局限性

最初尝试直接抛出自定义错误：

if(!Boolean(renderedCondition)) {
  throw new AssertTagAssertionError('something went wrong', ErrorCodes.Foo)
}

然后在渲染时捕获：

engine.parseAndRender(template, {}).catch(e => {
  if('originalError' in e && e.originalError instanceof AssertTagAssertionError){
    // 处理特定错误
  }
})

但这种方法存在以下问题：

1. LiquidJS 会将错误包装为 RenderError
2. originalError 属性是受保护的，无法直接访问
3. 错误类型信息在传递过程中丢失

最佳实践解决方案

LiquidJS 提供了 LiquidError 基类，我们可以通过继承它来创建自定义错误：

import { LiquidError } from "liquidjs";

class AssertTagAssertionError extends LiquidError {
  errorCode;

  constructor(err, errorCode, token) {
    super(err, token);
    this.errorCode = errorCode;
  }
}

在自定义标签中抛出这个错误：

class AssertTag extends Tag {
  *render(ctx, emitter) {
    throw new AssertTagAssertionError("验证失败", 400, this.token);
  }
}

在调用方可以这样捕获和处理：

liquid.parseAndRender("{% assert foo %}").catch((e) => {
  if (e instanceof AssertTagAssertionError) {
    console.error(e.message, e.errorCode);
    // 可以获取详细的错误信息
  } else {
    // 处理其他类型的错误
    throw e;
  }
});

技术优势

1. 类型安全：通过 instanceof 可以准确识别错误类型
2. 信息丰富：可以携带错误码、位置信息等元数据
3. 继承体系：与 LiquidJS 错误处理体系无缝集成
4. 可扩展性：可以方便地添加更多自定义错误类型

实际应用建议

1. 为不同的业务场景定义不同的错误类
2. 在错误类中包含足够的上下文信息
3. 考虑错误国际化需求
4. 记录错误发生时的模板位置信息
5. 设计统一的错误处理中间件

通过这种模式，开发者可以在 LiquidJS 模板中实现复杂的业务逻辑验证，并以类型安全的方式处理各种错误场景，大大提高了代码的健壮性和可维护性。