以用户为中心的 API 异常设计
这篇文章从前端开发中一个常见操作——设置元素高度——切入,对比了三种不同的API使用方式:原生的DOM属性赋值、YUI2的工具函数以及jQuery的封装方法。作者并非在讨论具体技术选型,而是借此生动案例,引出关于“以用户为中心”的API设计的核心思考。 核心观点在于,优秀的API设计应当降低用户的认知负担和使用成本。原生写法`elem.style.height = val`虽然直接,但要求使用者了解底层DOM模型,且可能面临跨浏览器的兼容性细节。YUI2和jQuery的写法,如`$(elem).height(val)`,则通过提供统一、语义清晰的接口,屏蔽了底层差异,让用户能够更专注于业务逻辑而非繁琐的技术实现。 文章通过这个细微的对比指出,无论是设计前端库的API,还是构建后端服务或微服务接口,都应秉持相似的原则:即从“用户”(开发者)的角度出发,思考如何让他们用得更顺手、更不容易出错。一个设计良好的异常处理机制或清晰的接口文档,与简洁的API调用本身同等重要,共同构成了开发者体验的关键部分。