# 基础类型

TypeScript 支持与 JavaScript 几乎相同的数据类型，此外还提供了实用的枚举类型方便我们使用。

# 布尔值

let isDone: boolean = false

# 数字

和 JavaScript 一样，TypeScript 里的所有数字都是浮点数。这些浮点数的类型是 number。除了支持十进制和十六进制字面量，TypeScript 还支持 ECMAScript 2015中引入的二进制和八进制字面量。

let decLiteral: number = 20
let hexLiteral: number = 0x14
let binaryLiteral: number = 0b10100
let octalLiteral: number = 0o24

# 字符串

JavaScript 程序的另一项基本操作是处理网页或服务器端的文本数据。

let name: string = 'bob'
name = 'smith'

你还可以使用模版字符串，它可以定义多行文本和内嵌表达式。

let name: string = `Lee`
let age: number = 25
let sentence: string = `Hello, my name is ${ name }.

I'll be ${ age + 1 } years old next month.`

# 数组

有两种方式可以定义数组。第一种，可以在元素类型后面接上 []，表示由此类型元素组成的一个数组：

let list: number[] = [1, 2, 3]
let list: string[] = ['1', '2', '3']
let list: object[] = [{a:1}]

第二种方式是使用数组泛型，Array<元素类型>：

let list: Array<number> = [1, 2, 3]
let list: Array<string> = ['1', '2', '3']
let list: Array<object> = [{a:1}]

# 元组 Tuple

元组类型允许表示一个已知元素数量和类型的数组，各元素的类型不必相同。比如，你可以定义一对值分别为 string 和 number 类型的元组。

let x: [string, number]
x = ['hello', 10] // OK
x = [10, 'hello'] // Error

当访问一个已知索引的元素，会得到正确的类型：

console.log(x[0].substr(1)) // OK
console.log(x[1].substr(1)) // Error, 'number' 不存在 'substr' 方法

当访问一个越界的元素，会使用联合类型替代：

x[3] = 'world' // OK, 字符串可以赋值给(string | number)类型

console.log(x[5].toString()) // OK, 'string' 和 'number' 都有 toString

x[6] = true // Error, 布尔不是(string | number)类型

联合类型是高级主题，我们会在以后的章节里讨论它。

注意：自从 TyeScript 3.1 版本之后，访问越界元素会报错，我们不应该再使用该特性。

# 枚举

enum 类型是对 JavaScript 标准数据类型的一个补充。像 C# 等其它语言一样，使用枚举类型可以为一组数值赋予友好的名字。枚举列表中的每个符号代表一个整数值，一个比它前面的符号大的整数值。默认情况下，第一个枚举符号的值是 0

PS：枚举是为一组数组赋值名称，这个名称只能是String，赋值后可以通过数字下标或者String名直接访问。

例如：

enum Days { Sun, Mon, tue, Wed, thu, Fri, Sat };

其中Sun - Sat分别就对应了0-6 即Days[0]为Sun Days[6]为Sat

enum Color {Red, Green, Blue}
let c: Color = Color.Green

编译之后的代码为

var Color;
(function (Color) {
  Color[Color['Red'] = 0] = 'Red'; // 这里相当于设置了Color[0] = 'Red' 以及 Color['Red'] = 0
  Color[Color['Green'] = 1] = 'Green';
  Color[Color['Blue'] = 2] = 'Blue';
})(Color || (Color = {}));
var c = Color.Green;
console.log('Color', Color); // {0: "Red", 1: "Green", 2: "Blue", Red: 0, Green: 1, Blue: 2}

默认情况下，从 0 开始为元素编号。你也可以手动的指定成员的数值。例如，我们将上面的例子改成从 1 开始编号：

enum Color {Red = 1, Green, Blue}
let c: Color = Color.Green

或者，全部都采用手动赋值：

enum Color {Red = 1, Green = 2, Blue = 4}
let c: Color = Color.Green

编译后代码为

var Color;
(function (Color) {
    Color[Color["Red"] = 1] = "Red";
    Color[Color["Green"] = 2] = "Green";
    Color[Color["Blue"] = 4] = "Blue";
})(Color || (Color = {}));
var c = Color.Green;

枚举类型提供的一个便利是你可以由枚举的值得到它的名字。例如，我们知道数值为 2，但是不确定它映射到 Color 里的哪个名字，我们可以查找相应的名字：

enum Color {Red = 1, Green, Blue}
let colorName: string = Color[2]

console.log(colorName)  // 显示'Green'因为上面代码里它的值是2

# any

有时候，我们会想要为那些在编程阶段还不清楚类型的变量指定一个类型。这些值可能来自于动态的内容，比如来自用户输入或第三方代码库。这种情况下，我们不希望类型检查器对这些值进行检查而是直接让它们通过编译阶段的检查。那么我们可以使用 any 类型来标记这些变量：

let notSure: any = 4
notSure = 'maybe a string instead'
notSure = false // 也可以是个 boolean

在对现有代码进行改写的时候，any 类型是十分有用的，它允许你在编译时可选择地包含或移除类型检查。并且当你只知道一部分数据的类型时，any 类型也是有用的。比如，你有一个数组，它包含了不同的类型的数据：

let list: any[] = [1, true, 'free']
list[3] = 100
console.log(list) // [1, true, "free", 100]

# void

某种程度上来说，void 类型像是与 any 类型相反，它表示没有任何类型。 当一个函数没有返回值时，你通常会见到其返回值类型是 void：

function warnUser(): void {
  console.log('This is my warning message')
}

声明一个 void 类型的变量没有什么大用，因为你只能为它赋予 undefined 和 null：

let unusable: void = undefined

# null 和 undefined

TypeScript 里，undefined 和 null 两者各自有自己的类型分别叫做 undefined 和 null。和 void 相似，它们的本身的类型用处不是很大：

let u: undefined = undefined
let n: null = null

默认情况下 null 和 undefined 是所有类型的子类型。就是说你可以把 null 和 undefined 赋值给 number 类型的变量。

然而，当你指定了 node xxx --strictNullChecks 标记，null 和 undefined 只能赋值给 void 和它们各自，这能避免很多常见的问题。也许在某处你想传入一个 string 或 null 或 undefined，你可以使用联合类型 string | null | undefined。再次说明，稍后我们会介绍联合类型。

# never

never 类型表示的是那些永不存在的值的类型。例如， never 类型是那些总是会抛出异常或根本就不会有返回值的函数表达式或箭头函数表达式的返回值类型；变量也可能是 never 类型，当它们被永不为真的类型保护所约束时。

never 类型是任何类型的子类型，也可以赋值给任何类型；然而，没有类型是 never 的子类型或可以赋值给never 类型（除了 never 本身之外）。即使 any 也不可以赋值给 never。

下面是一些返回 never 类型的函数：

// 返回never的函数必须存在无法达到的终点
function error(message: string): never {
  throw new Error(message)
}

// 推断的返回值类型为never
function fail() {
  return error("Something failed")
}

// 返回never的函数必须存在无法达到的终点
function infiniteLoop(): never {
  while (true) {
  }
}

# object

object 表示非原始类型，也就是除 number，string，boolean，symbol，null或undefined 之外的类型。

使用 object 类型，就可以更好的表示像 Object.create 这样的 API。例如：

declare function create(o: object | null): void

create({ prop: 0 }) // OK
create(null) // OK

create(42) // Error
create('string') // Error
create(false) // Error
create(undefined) // Error

PS: declare 只是声明，函数体的实现和普通的函数实现没有区别

declare 声明相当于告诉 TypeScript 编译器，这儿有一个 create 函数，它的参数和返回值是怎样的，而 create 函数的实现并不是它关心的。举一个 declare 的使用场景，比如你引入了一个myLib 的库，这个库并没有任何 TypeScript 定义文件，但有一个全局的 myLib 变量可以使用。如果这个时候你在你的 TypeScript 文件中使用它，可以去这样声明它declare var myLib。

# 类型断言

有时候你会遇到这样的情况，你会比 TypeScript 更了解某个值的详细信息。通常这会发生在你清楚地知道一个实体具有比它现有类型更确切的类型。

通过类型断言这种方式可以告诉编译器，“相信我，我知道自己在干什么”。类型断言好比其它语言里的类型转换，但是不进行特殊的数据检查和解构。它没有运行时的影响，只是在编译阶段起作用。 TypeScript 会假设你，程序员，已经进行了必须的检查。

类型断言有两种形式。其一是“尖括号”语法：

let someValue: any = 'this is a string'

let strLength: number = (<string>someValue).length

另一个为 as 语法：

let someValue: any = 'this is a string'

let strLength: number = (someValue as string).length

两种形式是等价的。至于使用哪个大多数情况下是凭个人喜好；然而，当你在 TypeScript 里使用 JSX 时，只有 as 语法断言是被允许的。

即使是类型断言也不能直接将两个毫无关联的类型直接转换，你需要先将要断言的类型转换为‘unknown’，比如any类型然后才可以断言这个类型是什么类型。

type C = {
  readonly a: string,
  b: string
}

let p2: C = {a: '12', b: "234"}
// let c = p2.b as number // error Conversion of type 'string' to type 'number' may be a mistake because neither type sufficiently overlaps with the other. If this was intentional, convert the expression to 'unknown' first.
let c = p2.b as any
c = 3
let a: number = <number>c
console.log('a', a)

type C = {
  readonly a: string,
  b: any
}

let p2: C = {a: '12', b: "234"}
let c = p2.b as number
c = 3
console.log('c', c)

← 编写第一个 TypeScript 程序变量声明 →