窑子开张了(H)御宅屋衍生小说 - 窑子开张了(H)御宅屋...《OL的湿闷丝袜 91松下纱荣子》高清免费观看 -高清...
如何为 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.json，exports则仅该选项就足够了。不过，对于没有此配置的用户，我们还需要设置该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设置为true。outDir 选项在 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年12月22日，北京时间7月6日凌晨，欧洲杯四分之一淘汰赛正式开始。先是“斗牛士”军团西班牙2比1绝杀“日耳曼战车”德国队，一场极为精彩刺激的比赛，最后时刻梅里诺头球绝杀东道主德国。葡萄牙0比0闷平法国，双方点球大战，最终法国5比4险胜葡萄牙晋级四强，颁罗结束欧洲杯之旅。
窑子开张了(H)御宅屋衍生小说 - 窑子开张了(H)御宅屋...《OL的湿闷丝袜 91松下纱荣子》高清免费观看 -高清...
然而当人们逐渐冷静下来坐在蓑草堆旁边休息时有些胜利者和家属却对李大山产生了质疑小声嘀咕着：为什么这个乞丐懂得如何救助他人呢他是不是从哪儿学到了这些方法……
MFM、MFW 双认证，原装无线体验，mophie 三合一磁吸无线充电器评测原创2023-11-29 18:38·充电头网前言苹果自 MacBook 笔记本开始，就加入了磁吸充电功能，而在 iPhone 12机型上，正式推出了适用于手机的 MagSafe 无线充电，并推出多款磁吸保护壳、磁吸充电器等等周边配件，目前 iPhone 12~15 全系列均支持精准对位磁吸无线充电。mophie 作为与苹果（Apple lnc.）深度合作的品牌之一，旗下拥有众多与苹果原装相同体验的产物，此次，充电头网拿到 mophie 三合一无线充电器，相较于此前常规的充电产物，新款充电器在操作、工学等方面进行补充，接下来就一起看看这款无线充电器升级了哪些方面吧！产物介绍包装盒以黑色背景为主，正面印有手机、手表、耳机的工作状态图，同时，设备的充电动画也能清晰可见；左侧除“mophie”品牌字样和特色要点：无线快充、三设备同充、伸缩支架，最重要的是拥有“Made for WATCH丨iPhone丨MagSafe”认证标识，为苹果设备提供原装的无线充电体验。包装盒背面依旧拥有各项特色介绍以及操作释义图，以下将进行实际演示。打开包装，内部拥有三合一磁吸无线充电器本体，多语说明书、保修卡手册、充电器。从正面看，mophie 三合一磁吸无线充电器整体以金属灰配色为主，采用圆柱形连接杆+大底座设计，每个充电区域区分明显，从上到下依次为手机磁吸充电区域、手表磁吸充电区域，耳机无线充电区域设立在底座上，为矩形下沉式设计。手机磁吸充电区域为原 MagSafe 本体，亲肤硅胶手感，与外壳镶嵌拼接设计；拥有磁吸功能的 iPhone 手机吸附时，磁体之间可精准对齐，磁力强劲不易脱落。此外，手机磁吸充电模块支持俯仰角度调节，用户拥有更好的注视角度。与常规磁吸充电座不同，mophie 三合一磁吸无线充电器的连接支架采用金属机身设计，耐磨损防剐蹭；其拥有可调节高度功能，伸缩调节与渔具伸缩杆设计类似，标称可调节 20-40cm。手表磁吸充电模块正面采用中间凹陷圆弧亮面设计，使得 Apple Watch 手机凸起的玻璃表背更加贴合，依旧与外壳为镶嵌设计，不会剐蹭手表背部，细节十分到位；但此模块不具备角度调节功能。mophie 三合一磁吸无线充电器底座为加重钢底座设计，可增加整体的稳定性；同时，中间的下沉式矩形区域为耳机无线充电区域，中心区域丝印“qi”标识，下侧凹印“mophie”品牌字样。从侧面看，mophie 三合一磁吸无线充电器的圆柱形连接支架更加粗大，底座更宽大，保证了设备放置后的稳定性。背面可以看到手机、手表的充电区域以及连接支架的全貌，同时，底座边缘采用圆角封边设计，底部为楔形倒角，圆润不硌手。底部配备大面积防滑脚垫，并印有规格参数铭文。型号：MAGSFE-3lN1-EXT-STND；输入：12V/3A，36W；输出1（AirPods/AirPods Pro）：Qi 5W；输出2（Watch）：3.5W输出3（MagSafe Charger）：15W。底座部位拥有收纳式充电口设计，线材可卡扣在槽口位置，保证底座与桌面平行，加强稳定性。同时，可以看到内部充电端为圆孔 DC 端口，需搭配原装充电器方可通电使用。此外，底部中框处拥有条形充电提示灯，正常充电时显示雾白色灯效。配套的电源适配器为一体式连接线材设计，整体纯黑色调，线材采用钢丝线圈捆绑固定，线身柔软，可随意走线调整。线材的供电端头为 DC 圆孔，外壳为金属材质，更耐磨损耐氧化。适配器为固定式插脚设计，另贴有相关参数贴纸。型号：PSD1203000CW；输入：100-240V~50/60Hz Max 1.0A；输出：12V/3A 36W；制造商：深圳市普仕达电子科技有限公司。适配器外露线材长度约为153cm。底座部分长度约为145.08mm。底座部分宽度约为100.1mm。mophie 三合一磁吸无线充电器整体高度约为21cm，这个高度一般会超过显示屏幕下端，桌面使用可以放在屏幕旁边。伸缩支架伸展至最长后，mophie 三合一磁吸无线充电器高度可达41cm左右，约与标称一致。mophie 三合一磁吸无线充电器重量约为641.6g。日常使用对于支持磁吸无线充电功能，无论是 iPhone 还是具备无线充电功能的 Android 手机，都将实际使用，进行全面的分析体验。首先是最新的 iPhone 15系列手机，在裸机状态下的磁吸力方面，表现自然是无可挑剔。同时，iPhone 12~iPhone 15 系列手机实测可稳固吸附，mini 机型也能十分适配，无阻挡摄像头模组现象。同时，经过各个角度的调节使用，手机依旧稳固吸附，无掉落现象。同样，对于支持无线充电的手机来说，需搭配具备磁吸功能的手机壳等磁吸配件，方可拥有与 MagSafe 相当的吸附体验。此外，mophie 三合一磁吸无线充电器的耳机无线充电区域也能对无线充电功能的手机进行充电，但建议手机为裸机状态，手机壳的厚度会有一定程度的影响。如果用户具备苹果出行三件套（iPhone、Apple Watch、AirPods），mophie 三合一磁吸无线充电器能够完美解决三个设备的充电问题，打造简洁桌面。在此基础上，用户可自由调节连接支架的伸缩高度（20-40cm），放置在显示器旁，用户即可在平行视角下解锁使用 iPhone。最后，mophie 三合一磁吸无线充电器支持 StandBy 模式，当你的 iPhone 升级至 iOS17 版本系统后，并且支持息屏显示功能，iPhone 就可以当做“智慧摆件”使用。无线充电测试mophie 这款三合一磁吸无线充电器配备了苹果原厂的磁吸充电模块，通过了Made For MagSafe认证，下面来看看为iPhone手机充电方面的表现。首先，通过功率计读取mophie 三合一磁吸无线充电器的待机功耗，实测功耗约在0.73W，实际使用时可忽略不计。mophie 三合一磁吸无线充电器仅对 iPhone 15 手机进行无线充电，实测功率计上显示功率为20.57W 左右。mophie 三合一磁吸无线充电器仅对 iPhone 15 Plus 手机进行无线充电，实测功率计上显示功率为22.8W 左右。mophie 三合一磁吸无线充电器仅对 iPhone 15 Pro 手机进行无线充电，实测功率计上显示功率为22.66W 左右。mophie 三合一磁吸无线充电器仅对 iPhone 15 Pro Max手机进行无线充电，实测功率计上显示功率为22.86W 左右，除去损耗，约符合标称 15W 充电。mophie 三合一磁吸无线充电器仅对 Apple Watch Ultra 进行无线充电，实测功率计上显示功率为1.46W 左右。mophie 三合一磁吸无线充电器仅对 AirPods Pro 进行无线充电，实测功率计上显示功率为2.82W 左右。同样，此区域也可对手机进行无线充电，但需自行对准充电区域，实测功率计上显示功率为9.16W 左右。mophie 三合一磁吸无线充电器同时对 Apple Watch Ultra、AirPods Pro 进行无线充电，实测功率计上显示功率为4.85W 左右。mophie 三合一磁吸无线充电器同时对 iPhone 15 Pro、Apple Watch Ultra、AirPods Pro 进行无线充电，实测功率计上显示功率为26.79W 左右。mophie 三合一磁吸无线充电器同时对 iPhone 15、iPhone 15 Plus 进行无线充电，实测功率计上显示功率为 30.23W 左右。最后，mophie 三合一磁吸无线充电器同时对 iPhone 15 Pro、Apple Watch Ultra、iPhone 15 进行无线充电，实测功率计上显示功率为 30.75W 左右。充电全程测试将手机电量耗尽后，将iPhone 15 Pro 手机、Apple Watch Ultra分别与mophie 三合一磁吸无线充电器放置于25℃恒温箱中，接通电源，并使用 PA300 系列功率计记录数据，测试数据如下。将测试结果绘制折线图，可以看出使用mophie 三合一磁吸无线充电器为iPhone 15 Pro 手机充电至50%耗时约56分钟，充电至80%耗时约1小时36分钟，充电至100%耗时约2小时56分钟。将测试结果绘制折线图，可以看出使用mophie 三合一磁吸无线充电器为Apple Watch Ultra充电至50%耗时约39分钟，充电至80%耗时约1小时03分钟，充电至100%耗时约1小时40分钟。温度测试将mophie 三合一磁吸无线充电器和 iPhone 15 Pro 放入25℃恒温箱中，模拟220V 50Hz的市电环境，30分钟后采集为 iPhone 15 Pro 充电时的温度数据。从图中可以看出，mophie 三合一磁吸无线充电器为 iPhone 15 Pro 充电30分钟后使用热成像仪拍摄得磁吸无线充表面最高温度为37.3℃。这个温度对于日常使用来说，并不会感觉到烫手，触碰感觉较温和。同样将mophie 三合一磁吸无线充电器和 Apple Watch Ultra 放入25℃恒温箱中，模拟220V 50Hz的市电环境，30分钟后采集为 Apple Watch Ultra 充电时的温度数据。从图中可以看出，mophie 三合一磁吸无线充电器为 Apple Watch Ultra 充电30分钟后，使用热成像仪拍摄mophie 三合一磁吸无线充电器磁吸面最高温度为37.1℃。充电头网总结mophie 三合一磁吸无线充电器相比较此前无线充电系列产物而言，在支持苹果三设备无线充电的同时，加入了人体工学的可调节高度设计，或助力用户颈部得到放松；另外，它拥有苹果 Made for MagSafe/WATCH 双认证，苹果用户充电体验与原装无区别，随心搭配属于自己的简洁桌面美学。同时在日常刷剧时使用手机，更推荐搭配磁吸无线充电区域使用，既可以充当支架，支持 iOS 17 StandBy 模式，自定义组件，随时查看讯息；底座的无线区域除蓝牙耳机使用，也可以为另一部手机无线充；实测为iPhone 15 Pro 手机无线充满需要2小时56分钟，与原装充电器的无线充电体验相当。整体来看，mophie 三合一磁吸无线充电器对三台设备同时充电实测最大总输出30W左右，同时，用户或可随心搭配磁吸手机壳，为不支持磁吸充但支持无线充的手机设备也是十分友好。泥人张、杨柳青年画、田氏船模……