Wretch项目中实现请求级错误处理配置的技巧

在JavaScript的HTTP客户端库Wretch中，开发者经常需要为不同的请求配置不同的错误处理策略。本文将通过一个实际案例，探讨如何在Wretch中实现请求级别的错误处理配置，并避免常见的状态共享问题。

问题背景

在开发基于Wretch的HTTP客户端时，我们可能需要为不同的API请求设置不同的错误处理策略。例如，某些请求需要在特定HTTP状态码(如409冲突)时抛出错误，而其他请求则可能需要完全不同的错误处理逻辑。

初始实现方案

最初，开发者可能会尝试通过Wretch的addon机制来实现这一功能。一个典型的实现可能如下：

const throwOn: WretchAddon<ThrowOnAddon> = {
  wretch: {
    _throwOn: {
      all: false,
      statusCodes: []
    },
    throwOnAny() {
      this._throwOn.all = true;
      return this;
    },
    throwOn(statusCode: number) {
      this._throwOn.statusCodes.push(statusCode);
      return this;
    }
  }
};

这种实现看似合理，但实际上存在一个严重问题：所有Wretch实例共享同一个配置对象。这是因为JavaScript中对象是通过引用传递的，导致修改一个实例的配置会影响所有其他实例。

问题分析与解决方案

这个问题的根源在于JavaScript的对象引用机制。在原始实现中，所有Wretch实例共享同一个_throwOn对象引用。当我们在一个实例上调用throwOn或throwOnAny方法时，实际上是在修改所有实例共享的同一个对象。

正确的做法是每次修改配置时都创建一个新的配置对象。我们可以使用对象展开运算符(...)来实现这一点：

const throwOn: WretchAddon<ThrowOnAddon> = {
  wretch: {
    _throwOn: {
      all: false,
      statusCodes: []
    },
    throwOnAny() {
      return {
        ...this,
        _throwOn: {
          ...this._throwOn,
          all: true,
        }
      };
    },
    throwOn(statusCode: number) {
      return {
        ...this,
        _throwOn: {
          ...this._throwOn,
          statusCodes: [...this._throwOn.statusCodes, statusCode]
        }
      };
    }
  }
};

这种实现确保了每次配置修改都会创建一个新的对象，从而避免了实例间的状态共享问题。

实际应用示例

让我们看一个实际使用这个addon的例子：

const base = wretch('https://api.example.com').addon(throwOn);

const userApi = base.url('/users').throwOn(404);
const orderApi = base.url('/orders').throwOn(409);
const adminApi = base.url('/admin').throwOnAny();

// 每个实例都有独立的错误处理配置
console.log({
  userApi: userApi._throwOn,
  orderApi: orderApi._throwOn,
  adminApi: adminApi._throwOn
});

输出结果将显示每个实例都有自己独立的配置：

{
  userApi: { all: false, statusCodes: [404] },
  orderApi: { all: false, statusCodes: [409] },
  adminApi: { all: true, statusCodes: [] }
}

最佳实践建议

1. 避免共享状态：在Wretch addon开发中，始终注意避免在实例间共享可变状态。
2. 使用不可变更新：像上面示例那样，使用对象展开运算符或其他不可变更新技术来修改配置。
3. 考虑性能影响：虽然创建新对象会带来轻微的性能开销，但在大多数情况下这是可以接受的代价。
4. 清晰的文档：为你的addon编写清晰的文档，说明其行为和配置方式。

总结

在Wretch项目中实现请求级别的错误处理配置时，理解JavaScript的对象引用机制至关重要。通过采用不可变更新模式，我们可以确保每个Wretch实例都有自己独立的配置，从而实现灵活且可靠的错误处理策略。这种方法不仅适用于错误处理场景，也可以推广到其他需要请求级别配置的addon开发中。