jsDoc npm 模块任务
知识点掌握了,还需要不断练习才能熟练运用。下面golang学习网给大家带来一个文章开发实战,手把手教大家学习《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-factory
user declared state and actions types -> usestatefactory -> [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 extends { payload: infer P } ? (payload: P) => void : () => void }} Quack */
/**
* @template ST - State
* @template AM - Actions Map
* @typedef {(state: ST, action: AM) => ST} Reducer
*/
本篇关于《jsDoc npm 模块任务》的介绍就到此结束啦,但是学无止境,想要了解学习更多关于文章的相关知识,请关注golang学习网公众号!
PHP 函数中如何使用递归来处理嵌套数据结构?
- 上一篇
- PHP 函数中如何使用递归来处理嵌套数据结构?
- 下一篇
- Win11怎么更改存储位置 Win11更改存储位置操作步骤
-
- 文章 · 前端 | 1天前 | 流式处理 · javascript · 浏览器API · JavaScript UTF-8 ReadableStream Web Streams WritableStream TextEncoderStream
- Web Streams TextEncoderStream 怎样把字符串转换成字节流
- 358浏览 收藏
-
- 文章 · 前端 | 1天前 | javascript · 浏览器API · Web Locks API navigator.locks.request 同源标签页 共享任务 浏览器并发
- Web Locks API 怎样让同源标签页串行执行共享任务
- 445浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · css · CSS 组件样式 @scope scope root scope limit 选择器作用域
- CSS @scope 怎样限制选择器只作用于局部组件
- 210浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · JavaScript translate HTMLElement 产品名称
- JavaScript HTMLElement.translate 怎样标记无需翻译的产品名称
- 483浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · javascript · JavaScript IntersectionObserver rootMargin threshold intersectionRatio
- JavaScript IntersectionObserver 怎样设置多级阈值
- 289浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · JavaScript postMessage Message BroadcastChannel close 同源页面通信
- JavaScript BroadcastChannel 怎样在同源页面间传递消息
- 403浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · javascript · JavaScript iframe document importNode createHTMLDocument DOMImplementation
- JavaScript createHTMLDocument 怎样在独立文档中组装 HTML
- 329浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · websocket · JavaScript websocket CloseEvent 关闭事件
- JavaScript WebSocket 怎样处理 close 事件的 code 和 reason
- 239浏览 收藏
-
- 文章 · 前端 | 2天前 |
- JavaScript structuredClone 复制 Error 对象怎样保留错误信息
- 261浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · JavaScript Fetch AbortController AbortSignal abort reason
- JavaScript AbortController.abort(reason) 怎样把取消原因传给调用方
- 423浏览 收藏
-
- 文章 · 前端 | 2天前 | 前端 · 错误处理 · JavaScript Fetch response HTTP 404
- JavaScript fetch 怎样区分网络失败和 HTTP 404
- 239浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1172次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1154次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1338次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1280次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1138次使用
-
- JavaScript函数定义及示例详解
- 2025-05-11 502浏览
-
- 智能体安全引领产业升级——国内AI安全产品市场深度分析
- 2026-08-21 501浏览
-
- CSS变量简化按钮悬停效果技巧
- 2026-05-31 501浏览
-
- JavaScript符号类型详解与应用
- 2026-05-31 501浏览
-
- HTML剪贴板复制粘贴怎么用
- 2026-05-26 501浏览

