-
TypeScript 具有类型系统，是 JavaScript 的超集
-
业界有很多项目用 TypeScript 开发，包括：
- Web 框架：angular / mobx
- UI：ant-design / Grafana
- 游戏框架：Babylon.js / egret
- 服务器框架：nest.js / deno / typeorm
- App 框架：ionic / NativeScript
- IDE: VSCode
-
IDE 对 TypeScript 支持很友好，包括智能提示和依赖自动导入
-
支持类型校验、枚举、泛型、注解、接口
-
只负责编译，无运行时，不引入额外开销
-
始终与 ESMAScript 语言标准一致
-
安装依赖
yarn add typescript ts-node
-
创建必要文件
- index.ts
- tsconfig.json
-
测试运行
npx ts-node index.ts
-
编译成 JavaScript
tsc index.ts
const num: number = 123
function identity(num: number): number {
return num
}let boolArray: boolean[]interface Name {
first: string
second: string
}
let name: Name
name = {
first: "John",
second: "Doe"
}接口变量可以通过重复声明来扩展
interface Point {
x: number
y: number
}
interface Point {
z: number
}
let myPoint: Point = {
x: 1,
y: 2,
z: 3
}
console.log(myPoint.z)枚举是组织相关联的常量的一种方式，许多编程语言都有枚举数据类型
enum Colors {
Red,
Blue,
Green
}默认情况下，第一个枚举值是 0，后续值自增一
function reverse<T>(items: T[]): T[] {
const ret = []
for (let i = items.length - 1; i >= 0; i--) {
ret.push(items[i])
}
return ret
}
const sample = [1, 2, 3]
let reversed = reverse(sample)
reversed[0] = "1" // Error
reversed = ["1", "2"] // Error
reversed[0] = 1 // ok
reversed = [1, 2] // ok类型守护是一种错误提示机制。 JavaScript 一个常用的方式就是使用 typeof 或者 instanceof 来在运行时检查一个表达式的类型。TypeScript 现在可在 if 区域块中理解这种情况。
let xyz = {}
if (typeof xyz === "string") {
console.log(xyz.slice(3, 1)) // ok
console.log(xyz.splice(3, 1)) // Error
}在 JavaScript 中，依据不同参数类型或参数个数执行一些不同函数体的实现很常见。TypeScript 提供了重载函数的功能，可以精确定义函数接收的参数类型。
interface User {
name: string
age: number
}
declare function addAge(para: User | userId, flag?: boolean): numberTypeScript 提供使用类型注解的便捷语法，你可以使用 type Var = SomeType 的语法来创建别名：
type StrOrNum = string | number
let data: StrOrNum
data = 123
data = "123"
// 会检查类型
sample = true // Error与接口不同，你可以为任意的类型注解提供类型别名（在联合类型和交叉类型中比较实用），下面是一些能让你熟悉语法的示例。
type Text = string | { text: string }
type Coordinates = [number, number]
type Callback = (data: string) => void联合类型与下面的交叉类型利用了位运算逻辑操作符 | 和 &，先回顾下位运算逻辑：
1001 | 1010 = 1011 // 合并1
1001 & 1010 = 1000 // 只保留共有1在 TypeScript 中的表现：
interface IA {
a: string
b: number
}
type TB = {
b: number
c: number[]
}
type TC = IA | TB // TC类型的变量的键只需包含ab或bc即可，当然也可以abc都有
type TD = IA & TB // TD类型的变量的键必需包含abc实际用法：
function formatCommandline(command: string[] | string) {
let line = ""
if (typeof command === "string") {
line = command.trim()
} else {
line = command.join(" ").trim()
}
return line
}
var myType: string[] | string | number | boolean
// myType类型可以是字符串数组、字符串、数字、布尔值
myType = "type"
myType = ["a", "b", "c"]
myType = 100
myType = false
// 不可以是其他类型
myType = function() {} //报错在 JavaScript 中， extend 是一种非常常见的模式，在这种模式中，你可以从两个对象中创建一个新对象，新对象会拥有着两个对象所有的功能。交叉类型可以让你安全的使用此种模式：
function extend<T, U>(first: T, second: U): T & U {
const result = <T & U>{}
for (let id in first) {
;(<T>result)[id] = first[id]
}
for (let id in second) {
if (!result.hasOwnProperty(id)) {
;(<U>result)[id] = second[id]
}
}
return result
}
const x = extend({ a: "hello" }, { b: 42 })
// 现在 x 拥有了 a 属性与 b 属性
const a = x.a
const b = x.bany 类型在 TypeScript 类型系统中占有特殊的地位。它提供给你一个类型系统的「后门」，可以把类型检查关闭。在类型系统里 any 能够兼容所有的类型（包括它自己）。因此，所有类型都能被赋值给它，它也能被赋值给其他任何类型。
never 和 unknown 分别是 TypeScript 2.0 和 3.0 引入的新概念。
never 表示不会出现的类型，是最小子集，一般用在出现错误的场景；与 void 的差异在于，void 表示空类型，never 表示永远不会返回的类型。void 变量可以被赋空值，never 变量不能被赋值。
unknown 表示任意类型；与 any 不同的地方在于，any 是关闭了类型检查，并不代表一种类型集合。
never 示例：
实际上的体现就是只能抛出错误
function fail(message: string): never {
throw new Error(message)
}
let foo: never = 123 // 赋值会报错Any
let value: any
value = 'xxx' // OK
value.foo.bar() // OK
let value2: string = value // OKunknown
let value: unknown
value = 'xxx' // OK
value.foo.bar() // Error
let value2: string = value // Errorfunction log(message: string): void {
console.log(message)
}namespace Utility {
export function log(msg) {
console.log(msg)
}
export function error(msg) {
console.log(msg)
}
}
// usage
Utility.log("Call me")
Utility.error("maybe")namespace 关键字通过 TypeScript 编译后，与我们看到的 JavaScript 代码一样：
;(function(Utility) {
// 添加属性至 Utility
})((Utility || Utility = {}))type Keys = "a" | "b"
type Obj = { [p in Keys]: any } // -> { a: any, b: any }infer 表示在 extends 条件语句中待推断的类型变量。
type ReturnType<T> = T extends (...args: any[]) => infer R ? R : any其实这里的 infer R 就是声明一个变量来承载传入函数签名的返回值类型, 简单说就是用它取到函数返回值的类型方便之后使用。
你可以通过 typeof 关键字告诉编译器，某变量的类型与其他类型相同，如下所示：
let foo = 123
let bar: typeof foo // 'bar' 类型与 'foo' 类型相同（在这里是： 'number'）
bar = 456 // ok
bar = "789" // Error: 'string' 不能分配给 'number' 类型与捕获变量的类型相似，你仅仅是需要声明一个变量用来捕获到的类型：
class Foo {
foo: number // 我们想要捕获的类型
}
declare let _foo: Foo
// 与之前做法相同
let bar: typeof _foo.fookeyof 操作符能让你捕获一个类型的键。例如，你可以使用它来捕获变量的键名称，在通过使用 typeof 来获取类型之后：
const colors = {
red: "red",
blue: "blue"
}
type Colors = keyof typeof colors
let color: Colors // color 的类型是 'red' | 'blue'
color = "red" // ok
color = "blue" // ok
color = "anythingElse" // Errorhttps://www.staging-typescript.org/docs/handbook/release-notes/typescript-3-4.html#const-assertions
@TODO:
https://www.typescriptlang.org/docs/handbook/utility-types.html
Partial / Required / Readonly / Pick / Record / Exclude / Extract / ReturnType / ThisType / InstanceType / NonNullable / Parameters / ConstructorParameters
@TODO:
在 Typescript 中，只要文件存在 import 或 export 关键字，都被视为模块文件。
也就是不管 TS 文件还是 .d.ts 文件，如果不存在上述关键字，文件内的变量、函数、或者类型都是以全局作用域存在于项目中的。
存在上述关键字之一，则作用域为当前文件。
TypeScript 有两种主要的文件。
-
.ts 文件是包含类型和可执行代码的实现文件，这些编译产生 .js 文件。
-
.d.ts 文件是仅包含类型信息的声明文件，这些文件不会产生输出，它们仅用于类型检查。
编译 TypeScript 项目时，有一个选项可以生成声明文件（.d.ts），在此过程中，编译器会剥离所有函数和方法体，并仅保留导出类型的签名。然后，当第三方开发人员从 TypeScript 使用它时，生成的声明文件可用于描述 JavaScript 库或模块导出的虚拟 TypeScript 类型。
声明文件的概念类似于 C / C ++ 中的头文件的概念。
也可以手动为现有的 JavaScript 库或项目中的包编写类型声明文件。
Reference: @types/*.d.ts, src/type-scope/*.ts.
module.d.ts:
// 因为有 import 关键字，所以该文件内的类型作用域为当前文件。
import { Types } from 'mongoose'
// 可通过 declare global 显式声明里面的类型为全局作用域。
declare global {
type ObjectIdMixed = string | Types.ObjectId
}问题：全局类型 ts-node 运行抛错（TS2304），提示找不到 .d.ts 文件内的类型声明？
issue 链接： TypeStrong/ts-node#882
解决: https://github.com/TypeStrong/ts-node/blob/master/README.md#help-my-types-are-missing
NPM 模块里面的内建声明文件必须使用模块导出声明写法， 否则 TypeScript 编译无法通过。
问题：那么问题来了，对于类型声明文件 .d.ts ，tsc 编译并不会自动导出 .d.ts 文件到编译的结果目录。
解决：确定正确的导入路径，连同定义的 .d.ts 文件一起推到 NPM ？
function createGoods(value: number): { type: string } | undefined {
if (value < 5) {
return
}
return { type: 'apple' }
}
const goods = createGoods(10)
goods.type // ERROR: Object is possibly 'undefined'. (2532)
goods!.type // ✅// before
if (user && user.address) {
// ...
}
callback && callback()
// after
if (user?.address) { // 自动判断属性访问
// ...
}
callback?.() // 自动判断函数调用// before
const isBlack = params.isBlack || true // ❌
const isBlack = params.hasOwnProperty('isBlack') ? params.isBlack : true // ✅
// after
const isBlack = params.isBlack ?? true // ✅在 JavaScript 和许多程序语言中，称之为
Compound Assignment Operators（复合赋值操作符）
// Addition
// a = a + b
a += b;
// Subtraction
// a = a - b
a -= b;
// Multiplication
// a = a * b
a *= b;
// Division
// a = a / b
a /= b;
// Exponentiation
// a = a ** b
a **= b;
// Left Bit Shift
// a = a << b
a <<= b;新增：
a &&= b // a && (a = b)
a ||= b // a || (a = b)
a ??= b // a ?? (a = b)示例：
let values: string[];
// Before
(values ?? (values = [])).push("hello");
// After
(values ??= []).push("hello");Module path maps are not resolved in emitted code #10866 microsoft/TypeScript#10866
解决方案：
// tsc 编译后支持
tscpaths: tsc && tscpaths -p tsconfig.json -s ./src -o ./dist
// ts-node 运行支持
tsconfig-paths: npx ts-node -r tsconfig-paths/register src/index.tssrc/better/object-type
suggestion: microsoft/TypeScript#16464 (comment)
Enum:
superEnum 数字类型（变得更强）：
superEnum Grades {
silver = 2,
gold,
pt,
trial,
}
// 第三种变体（推荐）
console.log(Grades.values()) // [2, 3, 4, 5]
console.log(Grades.keys()) // ['silver', 'gold', 'pt', 'trial']
console.log(Grades.silver) // 2
console.log(Grades[2]) // 'silver'
console.log(Grades.map()) // { silver: 2, gold: 3, pt: 4, trial: 5, '2': silver, ... '5': 'trial' }
// 第一种变体
console.log(Grades.values) // [2, 3, 4, 5]
console.log(Grades.keys) // ['silver', 'gold', 'pt', 'trial']
console.log(Grades.map.silver) // 2
console.log(Grades.map[2]) // 'silver'
console.log(Grades.map) // { silver: 2, gold: 3, pt: 4, trial: 5, '2': silver, ... '5': 'trial' }
// 第二种变体，增加关键字 values、keys、map
console.log(Grades.values) // [2, 3, 4, 5]
console.log(Grades.keys) // ['silver', 'gold', 'pt', 'trial']
console.log(Grades.silver) // 2
console.log(Grades[2]) // 'silver'
console.log(Grades.map) // { silver: 2, gold: 3, pt: 4, trial: 5, '2': silver, ... '5': 'trial' }superEnum 字符串类型（变得更智能）：
superEnum Grades {
silver: string,
gold,
pt,
trial,
}
console.log(Grades.values) // ['silver', 'gold', 'pt', 'trial']
console.log(Grades.keys) // ['silver', 'gold', 'pt', 'trial']
console.log(Grades.map.silver) // 'silver'
console.log(Grades.map) // { silver: 'silver', gold: 'gold', pt: 'pt', trial: 'trial' }superEnum 类型混合：
superEnum Grades: string {
silver = 2,
gold: string,
pt = 'platinum',
trial,
}
console.log(Grades.values) // [2, 'gold', 'platinum', 'trial']
console.log(Grades.keys) // ['silver', 'gold', 'pt', 'trial']
console.log(Grades.map.silver) // 2
console.log(Grades.map[2]) // 'silver'
Real Reference: utils/zone-space