开发者社区

文档建议反馈控制台

最新优惠活动

文章/答案/技术大牛

发布

TypeScript JSDoc风格的类型是否具有常规类型的全部功能？

TypeScript JSDoc风格的类型并不具备常规类型的全部功能。JSDoc是一种用于JavaScript的注释风格，用于提供类型信息和文档说明。虽然JSDoc可以在TypeScript中使用，但它的类型系统相对较弱，与TypeScript的原生类型系统相比有一些限制。

JSDoc风格的类型可以提供基本的类型注解，例如指定变量的类型、函数的参数类型和返回值类型。它还可以描述对象的结构和属性类型，以及函数的重载等。这些注解可以提供一定的类型检查和代码提示，有助于提高代码的可读性和可维护性。

然而，与TypeScript的原生类型系统相比，JSDoc风格的类型存在一些不足之处。首先，JSDoc无法提供完整的类型推断，需要手动注解类型信息。其次，JSDoc的类型系统相对较弱，无法表达一些复杂的类型关系和约束，例如联合类型、交叉类型、泛型等。此外，JSDoc的类型注解也不会进行严格的类型检查，容易出现类型错误而不被发现。

对于TypeScript项目，建议尽量使用TypeScript的原生类型系统，而不是依赖于JSDoc风格的类型注解。TypeScript的原生类型系统更强大、更严格，可以提供更好的类型检查和代码提示。此外，TypeScript还提供了丰富的工具和生态系统，可以更好地支持开发过程中的各种需求。

腾讯云相关产品和产品介绍链接地址：

腾讯云开发者中心：https://cloud.tencent.com/developer
云服务器（CVM）：https://cloud.tencent.com/product/cvm
云数据库 MySQL 版：https://cloud.tencent.com/product/cdb_mysql
人工智能平台（AI Lab）：https://cloud.tencent.com/product/ailab
云存储（COS）：https://cloud.tencent.com/product/cos
腾讯云区块链服务（Tencent Blockchain）：https://cloud.tencent.com/product/tencentblockchain

相关搜索:Typescript -键/值类型，具有已知的键 Typescript:定义类型，如keyof，但具有特定的值类型 Typescript:过滤条件类型数组并具有适当的返回类型 Typescript如何检查具有多种类型的对象的类型 Typescript推送到具有连接类型的列表 TypeScript类型包含其他类型的键，但具有不同的值类型 Typescript迭代具有联合类型的对象具有TypeScript不兼容类型的Mobx错误具有TypeScript的可选泛型类型具有动态参数的TypeScript重用类型

相关搜索:

页面内容是否对你有帮助？

有帮助

没帮助

相关·内容

画图工具有哪些功能？画图工具可以打开的文件类型有哪些？

那么画图工具有哪些功能？画图工具可以打开的文件类型有哪些？下面小编就为大家来详细介绍一下。 image.png 一、画图工具有哪些功能？画图工具的功能是比较强大的，那么具体有哪些功能呢？...画图工具的功能基本分为对于图片的图像方面的处理以及尺寸的处理，画图工具可以对多种图像进行基本的处理，比如图像的部分模糊或者图像的色彩添加等等；画图工具还可以对图像进行剪裁、调整大小，以及拉伸或者扭曲等等基础功能...二、画图工具可以打开的文件类型有哪些？一般的画图工具都是可以打开多种文件的，那么具体可以打开什么文件类型呢？...小编在这里为大家整理了画图工具可以打开的文件类型，分别是：bmp、jpg、tiff、gif、pcx、tga、exif、fpx、svg、psd等等，一般文件类型多是jpg或者bmp格式。...关于画图工具的文章内容今天就介绍到这里，相信大家对于画图工具已经有所了解了，一般来说电脑自带的画图工具功能就比较强大了，不过大家如果有更多需求的话可以去网上下载一些新出的画图工具，功能也会更加地全面。

6.3K3 0

【译】不是 TypeScript 的 TypeScript -- JSDoc 的超能力

TypeScript 团队也在努力确保类型检查适用于常规 JavaScript 文件。...目录带有JSDoc注释的TypeScript 激活检查内联类型定义对象定义函数导入类型使用泛型枚举 typeof 从类扩展带有 JSDoc 注释的 TypeScript 在最优的情况下，...类型有很多很多，比评论中的几种基本类型更多。结果就是使用 JSDoc 类型可以让你走得很远。...请添加 @ts-ignore 标志： // @ts-ignore addVAT('1200', 0.1); // would error otherwise 内联类型定义参数的时候，希望确保尚未分配的变量具有正确的类型...: 403, notFound: 404, } 枚举与常规 TypeScript 枚举有很大不同, 枚举确保此对象中的每个键都具有指定的类型。

3.1K3 0

@ts-check

多亏了 TypeScript和 JSDoc，这两个愿望都有变成现实的可能。...JSDoc 添加类型如果仅仅使用 // [@ts-check](/user/ts-check)的话，我们只能使用它的自动类型推断功能，这对于大型项目来说是远远不够的，我们希望能像强类型语言一样指定每个变量的类型...本着不对项目产生侵入的原则，TypeScript可以通过 JSDoc 风格的注释来完成这一点。...; /** * 声明函数参数类型 * @param p0 {string} - TS 风格声明 p0 * @param {string} p1 - p1 是 string 类型参数 * @...TypeScript来享受类型系统的好处是最简单、学习成本最低的方法。

1.8K8 0

@ ts-check

多亏了 TypeScript和 JSDoc，这两个愿望都有变成现实的可能。...JSDoc 添加类型如果仅仅使用 // @ts-check的话，我们只能使用它的自动类型推断功能，这对于大型项目来说是远远不够的，我们希望能像强类型语言一样指定每个变量的类型。...本着不对项目产生侵入的原则，TypeScript可以通过 JSDoc 风格的注释来完成这一点。...; /** * 声明函数参数类型 * @param p0 {string} - TS 风格声明 p0 * @param {string} p1 - p1 是 string 类型参数 * @...{T} p1 * @return {T} */ function fn4(p1){} 写在最后对于老项目，使用 // @ts-check 和 JSDoc 引入 TypeScript来享受类型系统的好处是最简单

2.7K1 0

JSDoc ，一个可替代 TypeScript 的方案？

许多开发者喜欢使用TypeScript，因为它具有类型检查功能。然而，这需要额外的转译步骤，可能会带来麻烦和浪费时间。...JSDoc语法具有多种用途，包括用类型注释值，为函数指定参数和返回类型，为函数提供文档和使用信息，以及类型错误等。...以下是TypeScript相对于JSDoc的一些优势：更强大的静态类型：TypeScript提供了一种强大的类型模型，并在编译时捕获这些错误。...转译：TypeScript 可以通过其 polyfill 功能采用 JavaScript 语言的最新和未来特性。它可以将这些代码有效地转译成可理解的版本，以适应尚未支持这些特性的浏览器。...2 */ /** JSDoc containing two asterisks */ 这些是一些入门的基本功能。

5381 0

@ts-check

多亏了 TypeScript和 JSDoc，这两个愿望都有变成现实的可能。...JSDoc 添加类型如果仅仅使用 // [@ts-check](/user/ts-check)的话，我们只能使用它的自动类型推断功能，这对于大型项目来说是远远不够的，我们希望能像强类型语言一样指定每个变量的类型...本着不对项目产生侵入的原则，TypeScript可以通过 JSDoc 风格的注释来完成这一点。...; /** * 声明函数参数类型 * @param p0 {string} - TS 风格声明 p0 * @param {string} p1 - p1 是 string 类型参数 * @...TypeScript来享受类型系统的好处是最简单、学习成本最低的方法。

1.1K2 0

如何不编译使用 TypeScript

四月份发布的TypeScript 2.3支持通过注释中的类型说明来对原生 JavaScript 代码进行近代分析。您可以使用类 JSDoc 语法来描述函数功能并添加类型信息。...然后在文件的任何位置添加 TypeScript 的 JSDoc 类型注释。...你可以在 TypeScript wiki 中找到更多关于 TypeScript 支持 JSDoc 风格类型注释的示例。...库支持 TypeScript 会自动选择 Node 标准库的类型信息，因此您可以开始使用 Node 类型检查 Node 的大部分内置功能。...我甚至不需要在我的项目中添加 TypeScript 作为开发依赖项，我只是像文本编辑器功能那样处理类型检查，这样可以帮助我编写更好的代码。

1.9K4 0

有JSDoc还需要TypeScript吗

你可以通过使用JSDoc在JavaScript中获得TypeScript的所有好处 TypeScript所提供的是一个静态类型系统。这意味着类型信息在运行代码中没有影响。...当你的TypeScript被执行时，所有的类型信息都会完全丢失（这就是为什么你不写一个类型守卫，就不能测试一个变量是否是某个类型的原因）。...TypeScript分析器能够理解用JSDoc写的类型，并给你提供与.ts文件相同的静态分析。我不会在这里提供完整的语法文档。...虽然完全使用JSDoc进行类型声明是可能的，但这并不是最方便的。...建议所以现在我的建议是这样的：当你正在做一个有编译步骤的项目时，使用TypeScript没有什么坏处但是如果你不需要编译步骤，那么坚持使用JSDoc类型注释可能更容易。

2962 0

用什么策略把你的 JavaScript 迁移到 TypeScript

我们仅从 JavaScript 文件开始，然后将越来越多的文件切换到 TypeScript。我们可以继续使用普通的 JavaScript，并通过 JSDoc 注释添加类型信息，直到全部完成为止。...我们运行 TypeScript 编译器，但仅作为类型检查器（编译器选项 --noEmit）实用。通过 JSDoc 注释（请参见下面的示例）和类型定义文件添加类型信息。...一旦 TypeScript 的类型检查器不再报错，我们将用编译器来构建代码库（类似于先前的策略）。现在不急着从 .js 文件切换到 .ts 文件，因为整个代码库已经完全有了静态类型。...以下是通过 JSDoc 注释为普通 JavaScript 指定静态类型的方式： /** * @param {number} x - A number param....有时，在迁移过程中保持完整功能的代码可能具有优先权。等等… 当你把代码库从 JavaScript 迁移到 TypeScript 时都经历些什么？请在评论中告诉大家！

7601 0

不是Typescript用不起，而是JSDoc更有性价比？

业内开始用 TypeScript 是因为 TypeScript 提供了类型检查，弥补了 JavaScript 只有逻辑没有类型的问题，对于大型项目、多人协作和需要高可靠性的项目来说，使用 TypeScript...是很好的选择；静态类型检查的好处，主要包括：类型安全代码智能感知重构支持而 TS 带来的主要问题则有：某些库的核心代码量很小，但类型体操带来了数倍的学习、开发和维护成本 TypeScript...吾谓大弟但有武略耳，至于今者，学识英博，非复吴下阿蒙除了 JSDoc 本身能力的不断丰富，2018 年发布的 TypeScript 2.9 版本无疑是最令人惊喜的一剂助力；该版本全面支持了将 JSDoc...的类型声明定义成 TS 风格，更是支持了在 JSDoc 注释的类型声明中动态引入并解析 TS 类型的能力。...的类型检查工具的 IDE，比如以代表性的 VSCode 来说，其加持能使类型安全锦上添花；与 JSDoc 类型（即便不用TS语法也可以）对应的 TS 类型会被自动推断出来并显示、配置了 //@ts-check

3101 0

不需要TypeScript，JS+JSDoc够了？大佬说我想多了

当然，就目前的情况，在力所能及的情况下，我个人推荐能用 TypeScript 就用 TypeScript ，但是否要玩类型体操则根据开发者自身情况来决策。...每个项目和开发团队都有自己的需求和偏好。有些开发者可能认为 TypeScript 增加了额外的复杂性和学习曲线，或者觉得它在某些方面不符合他们的开发风格。...它提供了许多有价值的功能，如类型安全、代码智能感知和重构支持等，这些功能对于大型项目和团队协作非常有益。...我更期望看到后续 TypeScript 团队能优化这块的体验。刘易成：JSDoc 只能解决一部分类型的问题，而 TypeScript 是一个完整的类型系统。...工具支持的差异：尽管一些工具和编辑器可以利用 JSDoc 注释进行类型检查，但与 TypeScript 相比，它们的功能和智能感知可能有所限制。

3381 0

Angular 工具篇之文档管理

在安装 Compodoc 之前，我们先来简单了解一下它的特点：生成的文档结构清晰。支持多种主题风格，比如 laravel, original, material, postmark 等。...文档注释 comments Compodoc 使用 TypeScript AST 解析器和它的内部 API，因此注释必须是合法的 JSDoc 注释。...JSDoc Tags 由于 TypeScript 编译器的限制目前 Compodoc 只支持以下的 JSDoc 标签： @returns —— 描述返回值 @ignore —— 表示标记的内容永远不会出现在文档中...@param —— 定义一个参数的类型和描述 @link —— 定义链接另一个方法、文档或外部链接 @example —— 定义一个示例用法了解完上述标签，我们来看一个比较完整的示例（来源于 ionic-code-documentation...对 Angular 项目来说，除了 Compodoc 之外，你也可以考虑使用谷歌官方出品的 API 文档生成工具 Dgeni，它对外开放了丰富的接口，还支持插件扩展，具有非常强的定制性。

1.6K1 0

TS in JS 实践指北

他们更喜欢静态类型语言所带来的好处，并且最为关键的是，他们使用 Visual Studio、Eclipse 这些支持 TypeScript 的 IDE。但是纯前端同学很少会去选择一个这么重的 IDE。...这种规范由于格式美观，受到很多程序员小哥哥小姐姐的欢迎。也有很多牛x的前端库在使用它作为注释规范，比如 lodash。在这些之外，JSDoc 还有一些大家可能不了解的功能，我们就从这里开始。...} */ // 再赋予给 $ var $ = require('zepto') 这样全部的$都有zepto的 type 能力了。...改用 JSDoc 去注释代码：我们经常会习惯性使用//去注释代码，但是如果还需要 IDE 提示的话，我们可以改为 JSDoc 的注释风格。...我之所以喜欢 TS，就是被它的自动提示所吸引(又是静态类型语言玩剩的东西)。在深入了解之后，TS 的功能甚至弥补了我自身的一些缺点，比如粗心。深切的感受才会有深刻的觉悟。

4.4K2 0

检查JavaScript文件_TypeScript笔记18

写在前面 TypeScript 的类型检查不仅限于.ts，还支持.js 但为了确保文件内容只含有标准的 JavaScript 代码，.js文件按照 ES 语法规范来检查，因而不允许出现 TypeScript...另外，TypeScript 还支持一些用来控制类型检查的特殊注释： // @ts-nocheck：文件级，跳过类型检查 // @ts-check：文件级，进行类型检查 // @ts-ignore：行级，...（类实例）类型推断的依据，所以上例中C类实例的类型为： // TypeScript type C = { constructorOnly: number; constructorUnknown:...("end"); 同样，多次赋值时，类型为各值类型的联合不定参数推断 .js里会根据arguments的使用情况来推断是否存在不定参数，例如： // .js function sum() { var...对 CommonJS 模块的支持就是通过这种类型推断来完成的命名空间推断 .js里，类、函数和对象字面量都视为命名空间，因为它们与命名空间非常相似（都具有值和类型的双重含义、都支持嵌套、并且三者能够结合使用

2.4K5 0

TypeScript 5.3

因此，该功能在夜间模式下进行了试验，以获得更多的反馈。...通常这些都是不必要的比较，但您可能更喜欢它作为一种风格，或者避免围绕JavaScript真实性的某些问题。无论如何，以前的TypeScript在执行收缩时无法识别这样的表单。...通过跳过JSDoc解析进行优化当通过tsc运行TypeScript时，编译器现在将避免解析JSDoc。...|(SomeType & Type99999NINE)的联合。当检查一个联合体是否可以赋值给某个目标类型时，我们必须检查联合体的每个成员是否都可以赋值给目标类型，这可能会非常慢。...在TypeScript 5.3中，我们可以看到我们能够隐藏的原始交集形式。当我们比较类型时，我们做一个快速检查，看看目标是否存在于源交集的任何组成部分中。

2061 0

PHPDoc、JSDoc、Vue JSDoc相关的语法，持续记录

@param @param参数类型 $参数名称参数说明 - 用于指定一个函数或方法的参数类型、名称和说明。...*/ function OldMethod(){ // 该方法已被弃用 } JSDoc JSDoc 是一种用于为 JavaScript 代码提供文档的注释规范。 1....// TypeScript let name: string = 'Amy'; // JSDoc /** @type {string} */ let name = 'Amy'; Vue JsDoc Vue.js...的文档注释使用的是基于 JSDoc 的风格，但是添加了Vue.js 特有的运行时和模板相关的标签。.../** * Button 组件 * * @prop {Boolean} disabled 是否禁用 * @prop {String} type button 类型（按钮类型），可选值为 `'primary

2892 0

为你的 JavaScript 项目添加智能提示和类型检查

由于 JSDoc 能提供详细的类型信息，其也被 VSCode 等编辑器接受应用于智能提示。...基于 TypeScript 类型声明文件除了使用 JSDoc 提前声明类型，更为激进的做法是直接使用微软开发的 TypeScript，为整个项目带来完善的静态类型检查。...不过由于和 TypeScript 师出同门，VSCode 能够直接读取前者的类型声明文件，来为 JavaScript 提供智能提示（实际上 JavaScript 的智能提示功能就是基于 TypeScript...TypeScript 的类型声明文件以 .d.ts 为后缀，用于描述同名的 JavaScript 文件导出代码的类型，功能上类似于 C 语言的 .h 头文件。...不严格地来说，ts 类型声明文件就像用 TypeScript 语法将 JSDoc 的注释重写了一遍并提取到了单独的文件中。

3.3K2 0

JSDoc支持_TypeScript笔记19

TypeScript 类型系统解析这些 JSDoc 标记得到额外类型信息输入，并结合类型推断对.js文件进行类型检查 P.S.关于.js类型检查的更多信息，见检查 JavaScript 文件_TypeScript...thing = true; 语法方面，JSDoc 大多借鉴自Google Closure Compiler 类型标注，而 TypeScript 则有自己的一套类型语法，因此二者存在一些差异类型声明...，如果是个纯粹的类型声明文件（只含有@typedef的.js，类似于d.ts），JSDoc 方式会引入一个无用文件（只含有注释），而 TypeScript 方式则不存在这个问题 P.S.TypeScript...类型转换类型转换（TypeScript 里的类型断言）语法与 JSDoc 一致，通过圆括号前的@type标记说明圆括号里表达式的类型： /** @type {!...number}：表示number 而 TypeScript 里无法显式指定，类型是否含有 Null 只与--strictNullChecks选项有关： /** * @type {?

4.1K1 0

JSDoc 真能取代 TypeScript？

这几个月，想必大家都听到过一个新闻： Svelte 弃用 TypeScript，改用 JSDoc 了。...TypeScript 我们知道，是用来给 JS 加上类型的，可以实现类型提示和编译时的类型检查。那 JSDoc 能够完成一样的功能么？Svelte 是出于什么原因弃用 TS 的呢？...比如这样的文档：确实，这个是 JSDoc 最初的含义。但我们说的 JSDoc 并不是这个，而是 TS 基于 JSDoc 语法实现的，在注释里给代码添加类型的语法。...然后安装 typescript： npm install --save-dev typescript 创建 tsconfig.json 文件： npx tsc --init 生成的 tscconfig.json...这就是 JSDoc 最大的好处：无侵入的给 JS 加上类型，拥有和 ts 一样的类型检查、类型提示、生成 dts 等功能，但却不需要编译，因为 JS 代码可以直接跑。

3383 0

TS 进阶 - 实际应用 01

TypeScript 并不是只能检查 TS 文件，对于 JS 文件也可以通过类型推导与 JSDoc 的方式进行不完全的类型检查： // JavaScript 文件 let myAge = 18; //...都能被推导出其类型，而无初始值的 myName 也可以通过 JSDoc 标注的方式来显式标注类型。...这些类型声明就像在 TypeScript 中的类型标注一样，会存放特定的类型信息，同时由于它们并不具有实际逻辑，可以很方便使用类型声明来进行兼容性比较、工具类型的声明与测试等。...，TypeScript 会提示你，是否要安装 @types/xxx 相关的包。....ts 文件中，此时它是具有实际逻辑意义的，不能和类型混作一谈。

8211 0

点击加载更多

扫码

添加站长进交流群

领取专属 10元无门槛券

手把手带您无忧上云

扫码加入开发者社群

相关资讯

热门标签

活动推荐

运营活动

活动名称

广告关闭