也就是说我们将一个字符串赋值给了一个数字类型的变量是有问题的,这个时候我们未运行程序,但是编辑器已经帮我们分析出了代码可能存在的问题,这时候我们运行代码,是没有报错的。
因为这个类型检测只是让我们按照TypeScript的强类型语言检测类型问题,但是我们依然是JavaScript代码依然会按照JavaScript的代码逻辑运行,如是TypeScript代码的话,这里运行就会报错。
JSDoc 类型标记
既然ts-check这么好用,我们来看看 JSDoc 类型的注释支持哪些类型的检测。
根据官方文档,JSDoc现在支持下面几个类型检测:
-
@type
-
@param
(or@arg
or@argument
) -
@returns
(or@return
) -
@typedef
-
@callback
-
@template
-
@class
(or@constructor
) -
@this
-
@extends
(or@augments
) -
@enum
下面我们选择常用的标记进行说明,更多更详细的标记可以参考官方文档。
@type
描述:用来声明变量的类型。
/**
-
- string类型
-
@type {string}
*/
let a1;
/**
-
- windows对象类型
-
@type {Window}
*/
let a2;
/**
-
- string或者boolean类型
-
@type {string | boolean}
*/
let sb;
// -------- 多种方式指定数组类型--------
/** @type {number[]} */
var ns;
/** @type {Array.} */
var nds;
/** @type {Array} */
var nas;
// ---- 还可以指定对象字面量类型。 例如,一个带有a(字符串)和b(数字)属性的对象—
/** @type {{ a: string, b: number }} */
var var9;
@param和@returns
描述:@param
语法和@type
相同,但增加了一个参数名。
/**
-
声明函数参数类型
-
@param {string} p1 - p1 是 string 类型参数
-
@param {string=} p2 - p2 是可选的 string 类型参数
-
@param {string} [p3] - 另外一种可选参数写法
-
@param {string} [p4=“test”] - p4 是可选的 string 类型参数(默认值为 “test”)
-
@return {string} - 函数返回值是 string 类型
*/
function fn3(p1, p2, p3, p4){
// TODO
}
/**
-
用 “return” 说明函数的返回值类型
-
@return {number}
*/
function fn1() {}
/**
-
可以像使用 “@return” 一样使用 “@returns”
-
@returns {{a: string, b: number}}
*/
function fn2() {}
@typedef
描述:@typedef
可以用来声明复杂类型,和@param
类似的语法。
/**
-
用 “@typedef” 自定义复杂类型
-
@typedef {Object} SpecialType - 创建一个新的类型 ‘SpecialType’
-
@property {string} prop1 - SpecialType 属性 prop1 是 string 类型
-
@property {number} prop2 - SpecialType 属性 prop2 是 number 类型
-
@property {number=} prop3 - SpecialType 属性 prop3 是可选的 number 类型
-
@prop {number} [prop4] - SpecialType 属性 prop4 是可选的 number 类型
-
@prop {number} [prop5=42] - SpecialType 属性 prop5 是可选的 number 类型(默认值 42))
*/
/** @type {SpecialType} */
let specialTypeObject;
可以在第一行上使用
object
或Object
。
实验要求
最后
自我介绍一下,小编13年上海交大毕业,曾经在小公司待过,也去过华为、OPPO等大厂,18年进入阿里一直到现在。
深知大多数Java工程师,想要提升技能,往往是自己摸索成长,自己不成体系的自学效果低效漫长且无助。
因此收集整理了一份《2024年Java开发全套学习资料》,初衷也很简单,就是希望能够帮助到想自学提升又不知道该从何学起的朋友,同时减轻大家的负担。
既有适合小白学习的零基础资料,也有适合3年以上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Java开发知识点,不论你是刚入门Java开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门!
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!
上经验的小伙伴深入学习提升的进阶课程,基本涵盖了95%以上Java开发知识点,不论你是刚入门Java开发的新手,还是希望在技术上不断提升的资深开发者,这些资料都将为你打开新的学习之门!**
如果你觉得这些内容对你有帮助,需要这份全套学习资料的朋友可以戳我获取!!
由于文件比较大,这里只是将部分目录截图出来,每个节点里面都包含大厂面经、学习笔记、源码讲义、实战项目、讲解视频,并且会持续更新!