前端【免费下载链接】urqlThe highly customizable and versatile GraphQL client with which you add on features like normalized caching as you grow.项目地址https://gitcode.com/gh_mirrors/ur/urql点击查看免费下载导读urql/exchange-throw-on-error是 urql 官方提供的一个 exchange交换器用于把 GraphQL 响应中的部分错误partial error转化为字段访问时抛出的 JavaScript 异常当读取一个已被 GraphQL 标记为失败含于errors且path指向该字段的数据字段时程序会立即抛出对应错误。读完本文你将掌握该 exchange 的安装、在客户端中的接入方式、底层实现原理、精确的抛出语义顶层字段、嵌套对象、列表元素各自的差异以及它在 exchange 链中的推荐摆放位置。一、背景urql 的 exchange 机制与部分错误问题urql 是一个高度可定制的 GraphQL 客户端其核心架构围绕exchanges交换器展开。一个 exchange 是一个接收operations$流、经过变换后再把结果转发给forward的纯函数多个 exchange 像洋葱一样层层包裹形成请求与响应管线。官方文档在 docs/architecture.md 中系统描述了这一架构exchanges 管线图 直观展示了 operation 从客户端出发、经过缓存与取数、再回流为 result 的过程。在 GraphQL 中一个请求可以“部分失败”服务端返回的data字段仍然存在但某些字段因为 resolver 抛错而为null同时errors数组里记录了带有path的错误信息。默认情况下urql 会把这类情况封装为 CombinedError其中graphQLErrors保存归一化后的GraphQLError[]结果对象同时携带data与error。这意味着 UI 代码在读取data时并不知道某个字段实际已经失败容易把null当作“正常缺省值”处理导致静默的数据缺失。throwOnErrorExchange正是为解决这一问题而设计它把“字段失败”这个信息从error对象中搬运到数据本身让你在访问该字段的那一刻就收到异常从而把 GraphQL 的部分错误变成显式的、可被try/catch捕获的编程错误。二、安装该包与urql确切地说是urql/core一同使用。按 README 说明可以通过 yarn 或 npm 安装yarn add urql/exchange-throw-on-error # 或 npm install --save urql/exchange-throw-on-error从仓库内的 package.json 可以看出依赖关系peerDependencies要求urql/core: ^6.0.0即必须与 urql 6.x 的 core 配合使用dependencies包含urql/coreworkspace 版本、graphql-toe: ^1.0.0-rc.0提供核心的字段包装能力以及wonka: ^6.3.2流式处理依赖urql 底层使用。也就是说它并不是独立完成字段抛错逻辑而是建立在graphql-toe之上对结果数据进行一次“toethrow on error化”包装。三、在客户端中接入安装后从包中导入throwOnErrorExchange工厂函数并把它加入createClient的exchanges数组。README 给出的最小示例import { createClient, cacheExchange, fetchExchange } from urql; import { throwOnErrorExchange } from urql/exchange-throw-on-error; const client createClient({ url: /graphql, exchanges: [cacheExchange, throwOnErrorExchange(), fetchExchange], });注意两点throwOnErrorExchange是一个工厂函数需要调用throwOnErrorExchange()返回真正的 exchange 实例与cacheExchange、fetchExchange这类直接传入的模块级常量不同。它位于cacheExchange与fetchExchange之间。由于它修改的是返回给上层的结果数据放在缓存之后、取数之前可以同时作用于来自fetchExchange的响应和来自cacheExchange的缓存命中结果——从源码实现看它本身是透传型的不拦截 operation、不发起请求因此这一位置能让所有下游来源的结果都被处理。四、实现原理mapExchange graphql-toe该 exchange 的实现非常精简完整源码见 exchanges/throw-on-error/src/throwOnErrorExchange.tsexport const throwOnErrorExchange (): Exchange { return mapExchange({ onResult(result) { if (result.data) { const errors result.error result.error.graphQLErrors; result.data toe({ data: result.data, errors }); } return result; }, }); };逐行解读mapExchange这是 urql/core 提供的一个工具 exchange支持onOperation、onResult、onError三个回调。throwOnErrorExchange只使用onResult每个从下游forward返回的OperationResult都会先经过该回调再向上一层传递。回调的返回值会替换原始 resultmapExchange的实现中(onResult onResult(result)) || result这一分支负责此逻辑。result.error.graphQLErrorsCombinedError见 packages/core/src/utils/error.ts把网络错误与 GraphQL 错误归一化其中graphQLErrors是GraphQLError[]每个错误都携带path例如[object, inner]。这里取出的正是带路径的 GraphQL 错误列表。toe({ data, errors })来自graphql-toe包的核心函数它根据errors中的path信息把data中对应字段替换为“访问即抛错”的代理/包装对象。这也解释了为什么该 exchange 的文档明确指向graphql-toe包寻求更多细节——抛错字段的包装语义全部由它实现。从结构上可以推断由于onResult只修改result.data而不触碰result.error所以该 exchange 不会吞掉或改写原有的错误对象CombinedError依然保留在结果上供既有错误处理逻辑使用。它是在“原有错误处理”之上叠加了一层“字段访问级抛错”。五、精确的抛出语义行为边界该包的行为边界由其测试套件 exchanges/throw-on-error/src/throwOnErrorExchange.test.ts 完整刻画。测试使用一个模拟的forward注入包含null字段的data与带path的GraphQLError然后逐项断言访问行为。归纳如下1. 顶层字段错误若错误path为[topLevel]且data.topLevel null则res.data?.topLevel抛出该错误toThrow(top level error)res.data本身不抛错其它未出错的顶层字段如topLevelList[0]不抛错。2. 顶层列表元素错误若错误path为[topLevelList, 1]列表第二个元素为null则res.data?.topLevelList[1]抛出该错误其余元素topLevelList[0]不抛错。3. 嵌套对象字段错误若错误path为[object]且data.object null则访问res.data?.object抛出该错误访问res.data?.object.inner同样抛出该错误因为读取inner必然先读取object而object已被包装为抛错字段但访问res.data、res.data?.topLevel不受影响。4. 对象深层字段错误若错误path为[object, inner]且data.object.inner null则res.data?.object.inner抛出该错误访问res.data?.object本身不抛错——只有真正落到出错字段上才触发。5. 对象列表错误与深层列表元素错误错误path为[objectList]时res.data?.objectList、objectList[0]、乃至objectList[0].inner都会抛错父级被包装后其下所有读取都会经过抛错代理错误path为[objectList, 1, inner]时仅res.data?.objectList[1].inner抛错objectList[0].inner正常。总结出的语义模型抛错是按“错误路径”精确锚定的只有访问路径包含该错误path从根开始的前缀匹配的字段读取才会触发异常对出错字段的祖先如data本身读取不会抛错因为顶层data对象本身未被包装列表索引如path中的数字下标也被精确匹配未出错的兄弟元素不受影响数据中未被任何错误path指向的字段保持原样正常返回。这意味着你可以在try/catch中读取整块数据任何失败字段都会在读取时抛出对应GraphQLError而未失败字段照常可用——这正是“throw-on-error访问即抛错”语义的核心价值。六、使用建议与注意事项放置位置保持throwOnErrorExchange在cacheExchange之后、取数类 exchange 之前如 README 示例所示可确保缓存命中的结果同样经过字段包装。由于mapExchange的onResult回调可以是异步的详见 map.ts 的类型注释该 exchange 理论上也允许放在同步逻辑之后的任意位置但示例中的默认顺序是最稳妥的。与类型系统的配合由于该 exchange 在运行时把失败字段替换为“访问即抛错”的对象字段的静态类型并不会变化——TypeScript 仍然认为这些字段是该有的类型。你可以在类型层面自行提示“此数据可能存在抛错字段”但这不是该包的职责范围。适用的错误形态从实现看只有result.error.graphQLErrors中带path的 GraphQL 部分错误会被映射为字段抛错纯粹的网络错误networkError请求整体失败不会产生data自然也不会走toe分支if (result.data)为假。因此该 exchange 只针对“请求成功但字段失败”的场景。不要用它替代全局错误处理result.error仍保留配合onError类的全局处理如 mapExchange 的 onError 回调或其它错误处理 exchange可以实现“字段级抛错 全局日志/提示”的双重策略。七、验证与深入阅读实现源码exchanges/throw-on-error/src/throwOnErrorExchange.ts行为测试六类字段错误场景exchanges/throw-on-error/src/throwOnErrorExchange.test.ts底层mapExchange实现packages/core/src/exchanges/map.ts错误对象CombinedError与graphQLErrors的归一化packages/core/src/utils/error.tsurql 整体交换器架构docs/architecture.md 与 exchanges 管线图如果你想复现行为可在本仓库运行该包的测试pnpm --filter urql/exchange-throw-on-error test脚本定义见 package.json 的test字段测试用例即是对上述语义最权威的文档。赞分享前端【免费下载链接】urqlThe highly customizable and versatile GraphQL client with which you add on features like normalized caching as you grow.项目地址https://gitcode.com/gh_mirrors/ur/urql点击查看免费下载相关推荐ECC 在 OpenClaw Harness 上的安装落地与健康检查基于 .openclaw 目录的完整实战指南ECC 在 OpenClaw Harness 上的安装落地与健康检查基于 .openclaw 目录的完整实战指南 本篇指南聚焦当前仓库为 OpenClaw多前端PHP-Parser抛出错误器异常错误处理PHP Parser抛出错误器异常错误处理 引言为什么需要专业的错误处理机制 在PHP代码解析过程中语法错误、语义错误和运行时异常是不可避免的。传统的P编译器静态分析代码生成Relay throwOnFieldError 指令完全指南让字段级错误从静默为 null变为显式抛错Relay throwOnFieldError 指令完全指南让字段级错误从静默为 null变为显式抛错 throwOnFieldError 是 R前端开发工具上一篇推荐使用Windows 10 虚拟桌面增强器下一篇10分钟从零开始Arduino ESP32完整安装与开发实战指南创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
