ts深入理解笔记

深入理解typescript

编译上下文

  • 作用,用来给文件分组,告诉ts哪些文件是有效的,哪些是无效的。除了有效文件所携带信息外,编译上下文还包含有正在被使用的编译选择的信息。

tsconfig.json

  • tsconfig.json,用于去定义正在被使用的编译选择的信息。使用方式,创建tsconfig.json文件
  • 编译选择,可以通过compilerOptions来制定编译选择,如下所示
{
  "compilerOptions": {

    /* 基本选项 */
    "target": "es5",                       // 指定 ECMAScript 目标版本: 'ES3' (default), 'ES5', 'ES6'/'ES2015', 'ES2016', 'ES2017', or 'ESNEXT'
    "module": "commonjs",                  // 指定使用模块: 'commonjs', 'amd', 'system', 'umd' or 'es2015'
    "lib": [],                             // 指定要包含在编译中的库文件
    "allowJs": true,                       // 允许编译 javascript 文件
    "checkJs": true,                       // 报告 javascript 文件中的错误
    "jsx": "preserve",                     // 指定 jsx 代码的生成: 'preserve', 'react-native', or 'react'
    "declaration": true,                   // 生成相应的 '.d.ts' 文件
    "sourceMap": true,                     // 生成相应的 '.map' 文件
    "outFile": "./",                       // 将输出文件合并为一个文件
    "outDir": "./",                        // 指定输出目录
    "rootDir": "./",                       // 用来控制输出目录结构 --outDir.
    "removeComments": true,                // 删除编译后的所有的注释
    "noEmit": true,                        // 不生成输出文件
    "importHelpers": true,                 // 从 tslib 导入辅助工具函数
    "isolatedModules": true,               // 将每个文件作为单独的模块 (与 'ts.transpileModule' 类似).

    /* 严格的类型检查选项 */
    "strict": true,                        // 启用所有严格类型检查选项
    "noImplicitAny": true,                 // 在表达式和声明上有隐含的 any类型时报错
    "strictNullChecks": true,              // 启用严格的 null 检查
    "noImplicitThis": true,                // 当 this 表达式值为 any 类型的时候,生成一个错误
    "alwaysStrict": true,                  // 以严格模式检查每个模块,并在每个文件里加入 'use strict'

    /* 额外的检查 */
    "noUnusedLocals": true,                // 有未使用的变量时,抛出错误
    "noUnusedParameters": true,            // 有未使用的参数时,抛出错误
    "noImplicitReturns": true,             // 并不是所有函数里的代码都有返回值时,抛出错误
    "noFallthroughCasesInSwitch": true,    // 报告 switch 语句的 fallthrough 错误。(即,不允许 switch 的 case 语句贯穿)

    /* 模块解析选项 */
    "moduleResolution": "node",            // 选择模块解析策略: 'node' (Node.js) or 'classic' (TypeScript pre-1.6)
    "baseUrl": "./",                       // 用于解析非相对模块名称的基目录
    "paths": {},                           // 模块名到基于 baseUrl 的路径映射的列表
    "rootDirs": [],                        // 根文件夹列表,其组合内容表示项目运行时的结构内容
    "typeRoots": [],                       // 包含类型声明的文件列表
    "types": [],                           // 需要包含的类型声明文件名列表
    "allowSyntheticDefaultImports": true,  // 允许从没有设置默认导出的模块中默认导入。

    /* Source Map Options */
    "sourceRoot": "./",                    // 指定调试器应该找到 TypeScript 文件而不是源文件的位置
    "mapRoot": "./",                       // 指定调试器应该找到映射文件而不是生成文件的位置
    "inlineSourceMap": true,               // 生成单个 soucemaps 文件,而不是将 sourcemaps 生成不同的文件
    "inlineSources": true,                 // 将代码与 sourcemaps 生成到一个文件中,要求同时设置了 --inlineSourceMap 或 --sourceMap 属性

    /* 其他选项 */
    "experimentalDecorators": true,        // 启用装饰器
    "emitDecoratorMetadata": true          // 为装饰器提供元数据的支持
  }
}
  • TypeScript编译,好的IDE支持对ts的即时编译,如果想在使用tsconfig.js时从命令手动运行TypeScript编译器,可以通过下面的方式来处理
    • 运行tsc,会在当前目录或者是父级目录寻找tsconfig.js文件
    • 运行tsc -p ./path-to-project-direction,这个路径可以是相对路径也可以是绝对路径
  • 甚至可以使用tsc -w来启用ts编译器的观测模式,在检测到文件改动之后,将会重新编译

指定文件

  • 可以显示的指定需要编译的文件:
{
  "files": [
    "./some/file.ts"
  ]
}
  • 采用include或者是exclude选择来指定需要包含的文件和排除的文件,如下所示:
{
    "include": [
        "./folder"
    ],
    "exclude:: [
        ""./folder/**/*.spec.ts",
        "./folder/someSubFolder""
    ]
}
  • 一个示例用法: some/folder/**/* 意味着匹配所有的文件夹和所有文件(扩展名为.ts/.tsx,当开启了allowJs: true选择时,扩展名可以是.js/.jsx)

声明空间

  • 在ts中存在两种声明空间:类型声明空间和变量声明空间
    • 类型声明空间,用来当作类型注解的内容,如在所示:
    class Foo {};
    interface Bar {};
    type Bas = {};
    
    • 变量声明空间,变量声明空间包含可用作变量的内容。如上面所示的class Foo提供了一个类型的Foo到类型声明空间,此外它同样提供了一个变量Foo到变量声明空间当中,如下所示:
    class Foo {}
    const someVar = Foo;
    const someOthervar = 123;
    

模块

  • 全局模块,在默认情况下,当开始在一个新的TypeScript文件中写下代码时,其处于全局命名空间中。这种方式容易造成文件内的代码命名冲突。推荐使用文件模块
  • 文件模块,又被称之为外部模块。如果在ts文件的根级别位置含有import或者export,那么它会在这个文件中创建一个本地的作用域,如下所示:
//文件定义在foo.js文件中
export const foo = 123;

//文件定义在一个文件中
import { foo } from './foo';
const bar = foo;
文件模块详情
  • 文件模块拥有强大的功能和较强的可用性
commonjs、 amd 、 es modules 、 others
  • 首先需要明白关于这些模块系统的不一致性。需要根据不同的module选项来把TypeScript编译成不同的js模块类型。

  • 如何书写TypeScript模块

    • 放弃使用import/require语法即import foo = require(‘foo’)写法
    • 推荐使用ES模块语法
  • ES5模块语法

    • 使用export关键字导出一个变量或类型
        export const someVar = 123;
        export type someType = {
            foo: stringl
        }
    
    • export的写法除了上述的写法,还有下面这种
        const someVar = 123;
        type someType = {
            type: string;
        }
        export { someVar someType }
    
    • 采用重命名变量的方式导出
        const someVar = 123;
        export { someVar as aDifferentName };
    
    • 使用import关键字导入一个变量或者是一个类型
        import { someVar, someType } from './foo';
    
    • 通过重命令的方式导入变量或者类型:
        import { someVar as aDifferentName } from './foo';
    
    • 除了指定加载某个输出值,还可以使用整体加载,即用星号(*)指定一个对象,所有输出都加载在这个对象上面
        import * as foo from './foo';
        //此时可以使用'foo.someVar'和‘foo.someType’以及其他任何从‘foo'到处的变量或者类型
    
    • 只导入模块
        import 'core-js';
    
    • 从其他模块导入后,整体导出
        export * from './foo';
    
    • 从其他模块导入后,部分导出:
        export { someVar } from './foo';
    
    • 通过重命名,部分导出从另一个模块导入的项目:
        export { someVar as aDifferentName } from './foo';
    
  • 默认导入/导出

    • 使用export default
      • 在一个变量之前
      • 在一个函数之前
      • 在一个类之前
    • 导入使用import someName from 'someModule’的语法
  • 模块路径,存在两种截然不同的模块:

    • 相对模块路径,通过路径的方式来查找
    • 其他动态查找模块:(如: core-js, typestyle, react或者是react/core)
  • 相对模块路径

    • 如果文件 bar.ts 中含有 import * as foo from ‘./foo’,那么 foo 文件必须与 bar.ts 文件存在于相同的文件夹下
    • 如果文件 bar.ts 中含有 import * as foo from ‘…/foo’,那么 foo 文件所存在的地方必须是 bar.ts 的上一级目录;
    • 如果文件 bar.ts 中含有 import * as foo from ‘…/someFolder/foo’,那么 foo 文件所在的文件夹 someFolder 必须与 bar.ts 文件所在文件夹在相同的目录下。
  • 动态查找,当导入路径不是相对路径时,模块解析将会模仿Node模块解析器,如:

    • 当使用import * as foo from ‘foo’,将会按照如下的顺序查找模块:
      • ./node_modules/foo
      • …/node_modules/foo
      • …/…/node_modules/foo
      • 直到根目录
    • 当使用import * as foo from ‘something/foo’,将会按照下面的这种方式去查询
      • ./node_modules/something/foo
      • …/node_modules/something/foo
      • …/…/node_modules/something/foo
      • 直到根目录
  • 重写类型的动态查找

    • 在项目中,可以通过declare module ‘somePath’ 声明一个全局模块的方式,来解决查找模块路径的问题,如下所示:
        declare module  'foo' {
            export var bar: number;
        }
    
    • 接着引入该模块的内容
        import * as foo from 'foo';
    
  • import/require仅仅是导入类型,如下所示

import foo = require('foo');
  • 实际上,上面的语法表达两层含义:
    • 导入foo模块的所有类型信息
    • 确定foo模块运行时的依赖关系
  • 使用例子:懒加载
    • 类型推断需要提前完成,这就意味着,如果想要在bar文件里,使用从其他文件foo导出的类型,将采用下面的方式来处理:
        import foo = require('foo');
        let bar: foo.someType;
    
    • 在某些场景下,只想在需要加载模块foo,此时需要尽在类型注解中使用导入的模块名称,而不是在变量中使用。在编译js时,这些将被移除,接着需要手动导入需要的模块,如下所示:
        import foo = require('foo');
    
        export function loadFoo() {
            //懒加载foo,原始的加载仅仅用来做类型注解
            const _foo: tyoeof foo = require('foo');
        }
    
        import foo = require('foo');
        export function loadFoo() {
            require(['foo'], (_foo: typeof foo) => {
                //使用'_foo'替代'foo'来作为变量使用
            })
        }
    
    • 上述的这些场景通常在以下的情况使用:
      • 在web app中,当在特定路由上加载js时
      • 在node应用中,只想加载特定模块,用来加快启动速度
    • 使用例子:打破循环依赖
      • 类似于懒加载的使用用例,某些模块加载器(commonjs/node和amd/requires)不能很好的处理循环依赖。在这种情况下,一方面使用延迟加载代码,另一方面预先加载模块
    • 使用例子:确保输入
      • 当加载一个模块,只想引入其附加作用时,如果仅仅是import/require(导入)一些并没有与你的模块或者模块家在器有任何依赖的js代码,在经过ts编译后,这些将会被完全忽视。在这种情况下,可以使用一个ensureImport变量,来确保编译的js依赖与模块。如下所示:
          import foo = require('./foo');
          import bar = require('./bar');
          import bas = require('./bas');
      
          const ensureImport: any = foo || bar || bas
      
  • global.d.ts
    • 该文件,用来将一些接口或者类型放在全局命名空间里,这些定义的接口和类型能在你的所有ts代码里使用

命名空间

  • 在使用js时常用的命名空间的方式,是采用立即执行函数方式,如下所示:
    (function(something) {
        smoething.foo = 123;
    })(something || (something = {} ))
    
    • 在上面的实例中something || (something = {}) 允许匿名函数function (something) {} 向现有对象添加内容,或者创建一个新对象,然后向该对象添加内容。
    let something;
    
    (function(something) {
        something.foo = 123;
    })(something || (something = {}));
    
    console.log(something);
    // { foo: 123 }
    
    (function(something) {
        something.bar = 456;
    })(something || (something = {}));
    
    console.log(something); // { foo: 123, bar: 456 }
    
    • 在确保创建的变量不会泄露至全局命名空间时,这种方式在js中很常见,当基于文件模块使用时,无须担心这点,该模式仍然适用于一组函数的逻辑分组。因此在ts中提供了namespace关键字来描述这种分组,如下所示:
        namespace Utility {
            export function log(msg) {
                console.log(msg);
            }
    
            export function error(msg) {
                console.log(msg);
            }
        }
    
        //usage
        Utility.log('Call me');
        Utility.log('maybe');
    
    • ts经过编译后js代码如下所示:
        (function(Utility){
            //....
        })(Utility || (Utility = {}))
    

动态导入表达式

  • 其是es的一个新功能,允许你在程序的任意位置异步加载一个模块,TC39js委员会有一个提按,目前正处于第四阶段,它被称之为import () proposal for JavaScript
  • 此外webpack bundle有一个Code Splitting 功能,它允许你将代码块拆分为多个许多块,这些块在将来可被异步下载。因此,可以在程序中首先提供一个最小的程序启动包,并在将在异步加载其他模块
  • webpack实现代码分割的方式有两种:使用import() 和 require.ensure()(最后考虑,webpack具体实现)。因此期望ts的输出是保留import语句,而不是将其转化为其他任何代码
  • 在下面的这个例子中,演示了如何配置webpack和TypeScript2.4+,如下所示:
//webpack加载方式
import(/* webpackChunkName: "momentjs" */ 'moment')
    .then(moment => {
        //懒加载的模块拥有所有类型,并且能按期工作
        //类型检查会工作,代码引用也会工作 :100:
        const time = moment().format();
        console.log('Typescript >= 2.4.0 Dynamic Import Expression:');
        console.log(time);
    })
    .catch(err => console.log("Failed to load moment",err))



//tsconfig.json配置文件
{
    "compilerOptions": {
        "target": "es5",
        "module": "esnext",
        "lib": [
        "dom",
        "es5",
        "scripthost",
        "es2015.promise"
        ],
        "jsx": "react",
        "declaration": false,
        "sourceMap": true,
        "outDir": "./dist/js",
        "strict": true,
        "moduleResolution": "node",
        "typeRoots": [
        "./node_modules/@types"
        ],
        "types": [
        "node",
        "react",
        "react-dom"
        ]
    }
}

Typescript类型系统

  • ts类型系统的主要功能,以下为一些关键点
    • ts类型系统被设计为可选的
    • ts不会阻止js的运行,即使存在类型错误也不例外,这能让js逐步迁移至ts
    • ts中的一些数据类型

从js中迁移至ts包括以下步骤

  • 从js迁移到ts的步骤如下:
    • 添加一个tsconfig.json文件
    • 把文件扩展名.js改为.ts,开始使用any来减少错误
    • 开始在ts中写代码,尽可能的减少any的使用
    • 回到旧代码,开始添加类型注解,并修复已识别的错误
    • 为第三方js代码定义环境声明
  • 减少错误,代码迁移至ts后,ts将立即对代码进行类型检查,此时可以采用any来解决大部分的报错问题
  • 第三方代码,可以将js代码改成ts代码,但是不能全部都使用ts代码,这正是ts环境声明支持的地方,可以专门使用一个文件作为开始,然后向文件里添加东西。或者可以创建一个针对于特定库的声明文件
  • 第三方的npm模块,与全局变量声明类似,可以快速定义一个全局模块,如jq,如果你想把它作为一个模块来使用时,可以自己通过以下的方式来实现:
declare module 'jquery';

import * as $ from 'jquery';
  • 额外的非js资源,在ts中,甚至可以允许导入任何文件,例如.css文件(如果使用webpack样式加载器或css模块),只需要添加如下代码(放在global.d.ts):
declare module '*.css';
// 声明之后可以使用import * as foo from './some/file.css'

@types

  • 使用types,可以通过npm来安装使用@types,例如:jquery添加声明文件,如下所示
npm install @types/jquery
  • @types支持全局和模块类型定义
    • 全局@types,默认情况下,typescript会自动包含支持全局使用的任何声明定义。例如,对于jq,你应该能够在全局使用$符号
    • 模块@types,安装完成之后,不需要特别的配置,就可以像模块一样使用它
        import * as $ from 'jquery';
    
  • 控制全局,对于一些团队而言,拥有允许全局使用的定义是一个问题。因此可以通过配置tsconfig.json的compilerOptions.types选择,引入有意义的类型,如下所示:
    {
        "compilerOptions": {
            "types": [
                "jquery"
            ]
        }
    }

环境声明

  • 环境声明允许你安全的使用现有的js库,并且能让你的js,CoffeeScript或者其他需要编译成js的语言逐步迁移至Typescript中
  • 声明文件,可以通过declare关键字来告诉typescript,你正在试图表述一个其他地方已经存在的代码。如:写在js CoffeeScript或者是像浏览器和Node.js运行环境里的代码,如下所示:
foo = 123;


declare var foo: any;
foo = 123;
  • 你可以选择把这些声明放在.ts或者.d.ts里,在实际项目里,强烈建议你应该把声明放在独立的.d.ts里。如果一个文件有扩展名.d.ts,这意味着每个根级别的声明都必须以declare关键字作为前缀。这有利于让开发者清楚知道,
    在这里ts将不会把它编译成任何代码,同时开发者需要确保这些在编译时存在

  • 变量,当想告诉ts编译器关于process变量时,可以采用下面的这种方式

declare let process: any';

//允许你使用process,并能成功通过typescript的编译:
process.exit();


//推荐尽可能的使用接口,例如:
interface Process {
    exit(code?: number): void;
}

declare let process: Process;

接口

  • 接口的声明方式
interface Point {
    x: number;
    y: number;
}
  • 使用类实现接口,首先使用interface定义接口,之后使用implements关键字来确保兼容性,如下所示:
interface Point {
    x: number;
    y: number;
}

class Point  implements Point {
    x: number;
    y: number;
}
  • 并不是每一个接口都是很容易实现的,接口旨在声明js中可能存在的任意结构,思考下面的demo
interface Crazy {
    new(): {
        hello: number;
    }
}

class CrazyClass implements Crazy {
    constructor() {
        return {
            hello: 123
        }
    }
}

枚举

  • 组织收集有关联变量的一种方式,定义的方式是采用enum关键字,如下所示:
enum CardSuit  {
    Clubs,
    Diamonds,
    Hearts,
    Spades
}

  • 数字类型枚举和数字类型。数字类型枚举,允许将数字类型或者其他任何与数字类型兼容的类型赋值给枚举类型的实例

  • 数字类型枚举与字符串类型,从下面的例子中看出,你可以使用Tristate变量来把字符串枚举类型改造成一个数字或者是数字类型的枚举类型

enum Tristate {
    False,
    True,
    Unkown
}

//被编译成js代码后
var Tristate;
(function(Tristate){
    Tristate[(Tristate['False'] = 0)] = 'False';
    Tristate[(Tristate['True'] = 1)] = 'True';
    Tristate[(Tristate['Unkonw'] = 2)] = 'Unkonw';
})(Tristate || (Tristate = {}));
  • 改变与数字枚举关联的数字,默认情况下,第一个枚举值是0,然后每个后续值以此递增。也可以通过特定的赋值来改变给任何枚举成员关联的数字。可以将第一个枚举值设置为任意数值,后续会依次增加
  • 使用数字类型作为标志,枚举很好用途是用于作为标志。这些标志允许你检查一组条件中的某个条件是否为真。如下所示:
enum AnimalFlags {
    None  = 0,
    HasClaws = 1 << 0,
    CanFly = 1 << 1,
    EatsFish = 1 << 2,
    Endangered = 1 << 3,
}

//在这里使用左移符号,将数字1的二进制向左移动位置得到数字0001,0010,0100, 1000
  • 字符串枚举,枚举类型的值为字符串类型,如下所示:
export enum EvidenceTypeEnum {
  UNKNOWN = '',
  PASSPORT_VISA = 'passport_visa',
  PASSPORT = 'passport',
  SIGHTED_STUDENT_CARD = 'sighted_tertiary_edu_id',
  SIGHTED_KEYPASS_CARD = 'sighted_keypass_card',
  SIGHTED_PROOF_OF_AGE_CARD = 'sighted_proof_of_age_card'
}

lib.d.ts

  • 当你安装typescript时,会顺带安装一个lib.d.ts声明文件。这个文件包含js运行时以及DOM中存在各种常见的环境声明
    • 自动包含在Typescript项目的编译上下文中;
    • 它能让你快速开始书写经过类型检查的js代码;
  • 你可以指定 --noLib的编译命令行标志(或者在tsconfig.json中指定选项noLib: true)
  • 使用例子,如下所示
const foo = 123;
const bar = foo.toString();

//这段代码的类型检查正常,因为lib.d.ts为所有js对象定义了toString方法,如果在noLi选项下,使用相同的代码,这将会出现类型检查错误
  • 观察lib.d.ts的内容,其主要是一些变量声明(如:window、document、math)和一些类似的接口声明(如:Window、Document、Math),寻找代码类型(如:Math.floor)的最简单方式是使用IDE的F12(跳转定义),如下面的window接口定义
interface Window
  extends EventTarget,
    WindowTimers,
    WindowSessionStorage,
    WindowLocalStorage,
    WindowConsole,
    GlobalEventHandlers,
    IDBEnvironment,
    WindowBase64 {
  animationStartTime: number;
  applicationCache: ApplicationCache;
  clientInformation: Navigator;
  closed: boolean;
  crypto: Crypto;
  // so on and so forth...
}
  • 修改原始类型,在ts中,接口是开发式的,这意味着当你想使用不存在的成员时,只需将它们添加至lib.d.ts中的接口声明即可。TypeScript将会自动接收它。注意当需要在全局模块中做这些修改,以使这些接口与lib.d.ts相关联。推荐创建一个global.d.ts的特殊文件
  • Window,仅仅是添加至window接口:
interface Window {
    helloword(): void;
}

//将允许你以类型安全的形式使用它
window.helloWorld = () => console.log('hello world');

// Call it
window.helloWorld();

// 滥用会导致错误
window.helloWorld('gracius'); // Error: 提供的参数与目标不匹配
  • 编译目标对lib.d.ts的影响,设置编译目标为es6时,能导致lib.d.ts包含更多像Promise现代内容的环境声明。
  • –lib选项,使用命令行的方式添加运行时的编译环境,如下所示:
tsc --target es5 --lib dom,es6

可调用的

  • 可以使用类型别名或者接口来表示一个可被调用的类型注解:
interface ReturnString {
    (): string;
}
//可以表示一个返回值为string的函数:
declare const foo: ReturnString;

const bar = foo();
  • 箭头函数,指定可调用的类型签名更容易,typescript运行你使用简单的简单函数类型注解,例如,在一个以number类型为参数,以string类型为返回值的函数中,写法如下:
const simple: (foo: number) => string = foo => foo.toString();
  • 可实例化,仅仅是可调用的一种特殊情况,使用new作为前缀,如下所示:
interface CallMeWithNewToGetString {
  new (): string;
}

// 使用
declare const Foo: CallMeWithNewToGetString;
const bar = new Foo(); // bar 被推断为 string 类型

类型断言

  • ts允许覆盖它的推断,并且能以你任何想要的方式分析它,这种机制被称为类型断言,ts类型断言用来告诉编译器你比他更了解这个类型,并且它不应该发生错误
  • 使用as foo来为类型断言
  • 类型断言与类型转化,类型转化通常意味桌某种运行时支持。但是类型断言纯粹是一个编译时语法,同时也是一种为编译器提供关于如何分析代码的方法
  • ts是怎样确定单个断言是否足够,当S类型是T类型的子集,或者T类型是S类型的子集时,s能够被断言成T

freshness

  • 为了能让检查对象字面量类型更容易,ts提供了freshness的概念(它也被称之为更严格的对象字面量检查)用来确保对象字面量在结构上类型兼容,如下所示:
function logName(something: { name: string }) {
  console.log(something.name);
}

logName({ name: 'matt' }); // ok
logName({ name: 'matt', job: 'being awesome' }); // Error: 对象字面量只能指定已知属性,`job` 属性在这里并不存在。
  • 允许额外的属性,一个类型能够包含索引签名,以明确表明可以使用额外的属性,如下所示:
let: x :  { foo : number, [x: string]: any };
x = { foo: 1, baz: 2 }

类型保护

  • typeof,判断一个变量的简单数据类型
  • instanceof,用来看两个对象之间是否具有继承关系
  • in用来判断一个对象上的属性是否具有可枚举性
  • 字面量类型保护,当在联合类型里使用字面量时,可以检查它们是否有区别:
type Foo = {
  kind: 'foo'; // 字面量类型
  foo: number;
};

type Bar = {
  kind: 'bar'; // 字面量类型
  bar: number;
};

function doStuff(arg: Foo | Bar) {
  if (arg.kind === 'foo') {
    console.log(arg.foo); // ok
    console.log(arg.bar); // Error
  } else {
    // 一定是 Bar
    console.log(arg.foo); // Error
    console.log(arg.bar); // ok
  }
}

字符串字面量

  • 可以使用一个字符串字面量作为一个类型,如下所示:
let foo: 'Hello';
  • 其本身并不实用,但是可以在一个联合类型中组合创建一个强大的(实用的)抽象,如下所示:
type CardinalDirection = 'North' | 'East' | 'South' | 'West';
  • 其他字面量类型,如下所示:
type OneToFive = 1 | 2 | 3 | 4 | 5;
type Bools = true | false;

类型推断

  • ts能够根据一些简单的规则推断(检查)变量的类型,如定义变量,函数返回类型,赋值,结构化,解构时。
  • noImplicitAny,选择noImplicitAny用来告诉编译器,当无法推断一个变量时发生一个错误(或者只能推断为一个隐士的any类型),可以采用下面的这些方式:
    • 通过显示的添加:any的类型注解,来让它成为一个any类型
    • 通过一些更正确的类型注解来帮助TypeScript推断类型

类型兼容性

  • 用于确定一个类型是否能赋值给其他类型,
  • 安全性,typescript类型系统设置比较方便,它允许你有一些不正确的行为。如任何类型都被赋值给any
  • 结构化,ts对象是一种结构类型,这意味着只要结构匹配,名称也就无关紧要,如下所示:
interface Point {
    x: number;
    y: number;
}

class Point2D {
    constructor(public x: number, public y: number) {}
}

let p: Point;
//ok
p = new Point2D(1, 2)
  • 变体,对类型兼容性来说,变体是一个利于理解和重要的概念。对一个简单类型Base和Child来说,如果Child是Base的子类,Child的实例能被赋值给Base类型的变量,在由Base和Child组合的复杂类型的类型兼容性中,它取决于相同场景下Base与Child的体。
    • 协变,只在同一个方向
    • 逆变: 只在相反的方向
    • 双向协变:包括同一个方向和不同方向
    • 不变:如果类型不完全相同,则它们不完全兼容

Never

  • 程序语言的设计确实应该存在一个底部类型的概念,当你在分析代码流的时候,这会是一个理所当然存在的类型。ts就是这样一种分析代码流的语言,因此需要一个可靠的,代表永远不会发生的类型
  • never类型是ts中的底层类型,它自然被分配的一些例子:
    • 一个从来不会有返回值的函数
    • 一个总是会抛出错误的函数
  • 如下面的例子所示:
let foo: never = 123; // Error: number 类型不能赋值给 never 类型

// ok, 作为函数返回类型的 never
let bar: never = (() => {
  throw new Error('Throw my hands in the air like I just dont care');
})();

  • 与void的差异,void表示没有任何类型,never表示永远不存在的值的类型

辨析联合类型

  • 当类中含有字面量成员时,可以用该类的属性来辨析联合类型,如下所示:
interface Square {
  kind: 'square';
  size: number;
}

interface Rectangle {
  kind: 'rectangle';
  width: number;
  height: number;
}

type Shape = Square | Rectangle;

function area(s: Shape) {
  if (s.kind === 'square') {
    return s.size * s.size;
  } else if (s.kind === 'rectangle') {
    return s.width * s.height;
  }

  // 如果你能让 TypeScript 给你一个错误,这是不是很棒?
}
  • Switch语句,可以通过switch来实现以上例子
function area(s: Shape) {
  switch (s.kind) {
    case 'square':
      return s.size * s.size;
    case 'rectangle':
      return s.width * s.height;
    case 'circle':
      return Math.PI * s.radius ** 2;
    default:
      const _exhaustiveCheck: never = s;
  }
}

索引签名

  • 可以用字符串访问js对象,用来保存对其他对象的引用,如下所示:
  • 声明一个索引签名,通过使用any来让Typescript允许可以做任意想做的事情,如下所示:
const foo: {
  [index: string]: { message: string };
} = {};

// 储存的东西必须符合结构
// ok
foo['a'] = { message: 'some message' };

// Error, 必须包含 `message`
foo['a'] = { messages: 'some message' };

// 读取时,也会有类型检查
// ok
foo['a'].message;

// Error: messages 不存在
foo['a'].messages;
  • 所有成员都必须符合字符串的索引签名,如下所示:
// ok
interface Foo {
  [key: string]: number;
  x: number;
  y: number;
}

// Error
interface Bar {
  [key: string]: number;
  x: number;
  y: string; // Error: y 属性必须为 number 类型
}
  • 使用一组有限的字符串字面量,一个索引签名可以通过映射类型来使索引字符串为联合类型中的一员,如下所示:
type Index = 'a' | 'b' | 'c';
type FromIndex = { [k in Index]?: number };

const good: FromIndex = { b: 1, c: 2 };

// Error:
// `{ b: 1, c: 2, d: 3 }` 不能分配给 'FromIndex'
// 对象字面量只能指定已知类型,'d' 不存在 'FromIndex' 类型上
const bad: FromIndex = { b: 1, c: 2, d: 3 };
  • ts同时拥有string和number类型的索引签名,如下案例所示:
interface ArrStr {
  [key: string]: string | number; // 必须包括所用成员类型
  [index: number]: string; // 字符串索引类型的子级

  // example
  length: number;
}

流动的类型

  • ts类型系统非常强大,他支持其他任何单一语言无法实现的类型流动和类型片段。关键的动机在于:当你改变其中一个时,其他相关的就自动更新,并且当有事情变糟糕时,你会得到一个友好的提示
  • 复制类型和值,当你想移动一个类时,你可能会想要做以下的事情:
class Foo {}
const Bar = foo;
let bar: Bar; //error: 不能找到名称'Bar',此时的Bar是一个变量不是类型
  • 捕获变量的类型,通过typeof操作符在类型注解中使用变量,允许你告诉编译器,一个变量的类型与其他类型相同,如下所示:
let foo = 123;
let bar: typeof foo
  • 捕获类成员的类型,仅仅需要声明一个变量用来捕获到的类型,如下所示:
class Foo {
    foo: number;
}

declare let _foo: Foo;

//与之前做法相同
let bar: typeof _foo.foo;
  • 捕获键的名称,keyof操作符能让你捕获一个类型的键。例如,你可以使用它来捕获变量的键名称,再通过typeof来获取类型
const colors = {
    red: 'red',
    blue: 'blue'
}

type Colors = keyof typeof colors;

let color: clors;

异常处理

  • js有一个Error类,用于处理异常。可以通过throw关键字来抛出一个错误。然后通过try/catch块来捕获此错误
try {
    throw new Error('Something bad happened');
} catch(e) {
    console.log(e);
}
  • 错误子类型,除了内置的Error类外,还有一些额外的内置错误,继承自Error类
    • RangeError,当数字类型变量或者参数超出其有效范围时,出现RangeError
    • ReferenceError,当引用无效时,会出现ReferenceError
    • SyntaxError,当解析无效js代码时,会出现SyntaxError的错误提示
    • TypeError: 变量或者参数不是有效类型时,会出现typeError的错误提示
    • URLError: 当传入无效参数至encodeURI()和decodeURI()时,会出现URLError的错误提示:

TypeScript编译原理

  • https://jkchao.github.io/typescript-book-chinese/compiler/overview.html#%E6%96%87%E4%BB%B6%EF%BC%9Autilities

你可能感兴趣的:(ts)