jsDoc npm 模块任务

目前我正在工作/维护遗留的 js/react 应用程序，没有办法重新工作到 typesript，这就是为什么我打开 jsdoc 作为 js 现有的开发时类型系统。 太长了；typescript npm 模块由 jsdoc 制作，useduck 在 70loc 下带回了 redux 的黄金时代。该模块在开发时的主要用例，帮助您的复杂状态保持类型安全。const [state, quack] = useduck(reducer, initialstate, actionsmap);登录后复制jsdoc-duck 从 typescript 到 jsdoc 之路当我创建了一个轻量级的 react state npm 库时，我对 typescript 的体验更加深入了：react-state-factoryuser declared state and actions types -&gt; usestatefactory -&gt; [state, dispatchedactoioncollection]登录后复制 测试 jsdoc 限制在我开始使用一些 jsdoc 注释来帮助我的工作之后，下一步有点更加大胆：将此模块重新设计为 jsdoc。乍一看，这是一项不可能完成的任务。但在花了几周时间了解 jsdoc 后，我看到了一些曙光。 恐怖类型系统：减速机在某个点上，当我尝试编写一个reducer函数时，我发现了jsdoc能力的硬限制，结果是一个quack，但当然它启动了一个空的{}。因此，只有reducer运行结束时才创建了正确的quack，因为该类型对包含所有请求的键的对象感到好奇。所以这个问题到现在我都无法解决，如果有人能给我一个好主意，我该如何解决它，请与我分享或作为合作者加入这个模块开发。 另一个陷阱：没有 ts 的模块中没有类型一开始我创建了一个 js 文件，其中包含所有必要的 jsdoc @typedef，迟早它会起作用。这就是我认为为他们创建节点模块的一步。但可悲的事实是，包含导出类型的 npm 模块不能仅与 jsdoc 一起使用，因此必须编译 d.ts，因此最后 jsdoc 模块不要说 100% js，而是构建也使用 typescript。 jsdoc-duck 模块中的@typedef正如您在 dev.to 论坛中所认识到的，语法高亮无法识别 jsdoc。其他错误的事情在我的测试中，如果你只写一行，这个 @typedef 就会起作用，所以它违背了干净的代码。在我的下一篇博文中，我将写的是这个库的具体用例，排序：使用 usereducer 简化和类型安全反应状态处理。/** * @template T - Payload Type * @typedef {T extends { type: infer U, payload?: infer P } ? { type: U, payload?: P } : never} ActionType */// @ts-ignore/** @template AM - Actions Map @typedef {{ [K in AM['type']]: K }} Labels */// @ts-ignore/** @template AM - Actions Map @typedef {{ [T in AM["type"]]: Extract<am type: t> extends { payload: infer P } ? (payload: P) =&gt; void : () =&gt; void }} Quack *//** * @template ST - State * @template AM - Actions Map * @typedef {(state: ST, action: AM) =&gt; ST} Reducer */</am>登录后复制 以上就是jsDoc npm 模块任务的详细内容，更多请关注我的其它相关文章！