《国家药监局:我国已建成国家药品智慧监管平台-国内频道...》剧情介绍:魏晋南北朝时期社会上文人多了起来不过如前所述当时还是流行坐车的拉车的话驴子不但不如马比牛也没有优势所以像阮籍那样骑驴是罕见的现象名士文人和牛建立深厚感情的故事要多得多摆2闭抢衡锐剑的匪修和刚才追逐郭颖儿的并不是一群人国家药监局:我国已建成国家药品智慧监管平台-国内频道...方源也紧追不舍:这一击他恐怕已经真正技穷了小毋从钢丝床上拿起手电筒与小谭在柜子里没有找到钱又在床铺上翻了一通仍然没有最后一阵乱翻从桌子抽屉里的笔记本里翻出140余元又从墙上挂的衣服口袋里搜出35.1元钱大约又搜了10多分钟再无所获
《国家药监局:我国已建成国家药品智慧监管平台-国内频道...》视频说明:如何为 NPM 包设置 JSDoc首发2023-09-02 10:17·启辰8几个月前JavaScript 生态系统出现了一些问题这是 Svelte 代码库从 TypeScript 迁移到 JavaScript 的过程是的这不是一个错字Svelte 在版本 3 到版本 4 的升级过程中用 JavaScript 进行了重写并将现有的 TypeScript 代码推送到了分支version-3尽管 Svelte 社区对 Rich Harris 和 Svelte 团队的这一决定非常担忧但自 Svelte 4 发布以来已经过去了两个月他们已经证明了他们的选择是正确的在本文中我们将探讨如何使用 JSDoc 编写 npm 包以及它如何显着增强开发人员体验例子单独用文字来解释多段源代码似乎很难所以我准备了StackBlitz和Github链接代码分析从package.json项目根目录中的文件开始让我们快速浏览一下重要部分// ./package.json "scripts": { "dts": "pnpm -r dts", "lint": "tsc && eslint --fix .", "test": "vitest run" },该文件中package.json包含三个脚本dts用于.d.ts使用 JSDoc 生成文件lint执行编码约定检查并test用于运行测试// ./pnpm-workspace.yamlpackages: - 'packages/*'该pnpm-workspace.yaml文件是用于管理本地包的配置文件// ./tsconfig.json "module": "ES6", "moduleResolution": "Node", "noEmit": true,在该tsconfig.json文件中module和moduleResolution选项分别设置为ES6和Node用于兼容性检查此外该noEmit选项设置为true仅在运行命令时执行类型检查pnpm lint// ./.eslintrc.json "ignorePatterns": ["**/@types/**/*.d.ts"]该文件夹中的文件@types是自动生成的因此它们被排除在 eslint 检查之外在syntax和test文件夹中创建文件用于类型检查和测试目的库包位于该packages文件夹下// ./packages/my-lib/package.json "exports": { ".": { "default": "./index.js", "types": "./@types/index.d.ts" }, "./math": { "default": "./src/math/index.js", "types": "./@types/src/math/index.d.ts" }, "./string": { "default": "./src/string/index.js", "types": "./@types/src/string/index.d.ts" }, "./type-test": { "default": "./src/type-test/index.js", "types": "./@types/src/type-test/index.d.ts" }, "./@types": "./src/public.d.ts" }, "typesVersions": { "*": { "*": ["@types/index.d.ts"], "math": ["@types/src/math/index.d.ts"], "string": ["@types/src/string/index.d.ts"], "type-test": ["@types/src/type-test/index.d.ts"], "@types": ["src/public.d.ts"] } },要在库中定义子路径模块我们需要在package.json文件中使用多个选项如果用户设置moduleResolution为Node16或NodeNextin tsconfig.jsonexports则仅该选项就足够了不过对于没有此配置的用户我们还需要设置该typesVersions选项// ./packages/my-lib/tsconfig.json{ "compilerOptions": { "allowJs": true, "allowSyntheticDefaultImports": true, "checkJs": true, "declaration": true, "declarationDir": "@types", "declarationMap": true, "emitDeclarationOnly": true, "lib": ["ES2020", "DOM", "DOM.Iterable"], "module": "NodeNext", "outDir": "silences wrong TS error, we don't compile, we only typecheck", "skipLibCheck": true, "strict": true, "target": "ESNext" }}为了在项目中使用JSDoc我们需要将allowJs和checkJs设置为trueoutDir 选项在 tsconfig.json 文件中配置以抑制错误消息如果另外配置了declaration、declarationDir、declarationMap和emitDeclarationOnly选项则可以使用tsc命令分析JSDoc并在@types文件夹中生成d.ts和d.ts.map文件使用 JSDoc 时将模块选项设置为 NodeNext 可以提供多种便利的好处// ./packages/my-lib/src/private.d.ts/* eslint-disable no-unused-vars */type NumberType = number;type ConcatParam = string | number | boolean;type A = { type: 'A'; a(): string;};type B = { type: 'B'; b(): string;};type C = { type: 'C'; c(): string;};type ABC = A | B | C;通常类型以private.d.ts.为了抑制 ESLint 扩展的错误消息我们使用eslint-disable no-unused-vars.// ./packages/my-lib/src/public.d.ts/* eslint-disable no-undef */export { ConcatParam}要导出写入的类型private.d.ts我们需要export在单独的文件中编写语句public.d.ts不幸的是不支持自动完成因此我们需要小心拼写错误同样为了忽略来自 VSCode 扩展的错误消息我们使用eslint-disable no-undef.JS文档TypeScript 提供静态类型检查帮助开发人员提前识别代码中的潜在错误但是您可以将 JSDoc 引入现有的 JavaScript 项目而无需从头开始从而获得好处通过使用 JSDoc 指定变量、函数、类等的类型信息TypeScript 还可以利用此信息进行类型检查// js source/** @param {ABC} abc */export default function(abc) { if (abc.type == "A") return abc.a() if (abc.type == "B") return abc.b() return abc.c()}@type您可以使用、@param、等标签应用类型@return并且还支持类型保护等类似功能没有任何问题此外将module选项设置tsconfig.json为NodeNext使您能够使用在d.ts不包含export语句的文件中编写的类型而不会出现任何问题// js source/** * @param {import("../../public.js").ConcatParam[]} strs */export default function concat(...strs) { let result = "" for (const str of strs) { result += str } return result}// auto-generated d.ts/** * @param {import("../../public.js").ConcatParam[]} strs */export default function concat(...strs: import("../../public.js").ConcatParam[]): string;//# sourceMappingURL=concat.d.ts.mapJSDoc 的import语句允许您从其他文件导入类型但它们与d.ts该命令生成的文件不兼容tsc因此建议不要使用它们/** @typedef {string | number} ConcatParam *//** * @param {ConcatParam[]} strs */export default function concat(...strs) { let result = "" for (const str of strs) { result += str } return result}// auto-generated d.ts/** @typedef {string | number} ConcatParam *//** * @param {ConcatParam[]} strs */export default function concat(...strs: ConcatParam[]): string;export type ConcatParam = string | number;//# sourceMappingURL=concat.d.ts.map@typedef由于类似的兼容性问题也不建议使用标签结论我们详细介绍了如何使用 JSDoc 创建 npm 包包括子路径模块回到家中王浩躺在沙发上拿出手机给伯伯李强发了一条微信:伯伯谢谢您那天的话我现在明白家人之间的坦诚和信任是多么重要今后我会努力工作同时也会保持与家人的真诚沟通
招凝看着秦恪渊还自然的磨着墨她笑道若是在以前招凝肯定不会想到有一天师叔会站在招凝身边给招凝磨墨但他们就像打不死的小强一样用一场场硬仗、一分分拼搏换来了今天的荣耀
2024-11-10 20:52:12