TypeScript ..
TypeScript ..

TypeScript使用手册

TypeScript 1.8

完整的破坏性改动列表请到这里查看:breaking change issues。

现在生成模块代码时会带有"use strict";头

在ES6模式下模块总是在严格模式下解析，对于生成目标为非ES6的却不是这样。从TypeScript 1.8开始，生成的模块将总为严格模式。这应该不会对现有的大部分代码产生影响，因为TypeScript把大多数因为严格模式而产生的错误当做编译时错误，但还是有一些在运行时才发生错误的TypeScript代码，比如赋值给NaN，现在将会直接报错。你可以参考MDN Article学习关于严格模式与非严格模式的区别。

若想禁用这个行为，在命令行里传--noImplicitUseStrict选项或在tsconfig.json文件里指定。

从模块里导出非局部名称

依据ES6/ES2015规范，从模块里导出非局部名称将会报错。

例子

export { Promise }; // Error

推荐

在导出之前，使用局部变量声明捕获那个全局名称。

const localPromise = Promise;
export { localPromise as Promise };

默认启用代码可达性（Reachability）检查

TypeScript 1.8里，我们添加了一些可达性检查来阻止一些种类的错误。特别是：

  1. 检查代码的可达性（默认启用，可以通过allowUnreachableCode编译器选项禁用）

       function test1() {
       return 1;
       return 2; // error here
   }

   function test2(x) {
       if (x) {
           return 1;
       }
       else {
           throw new Error("NYI")
       }
       var y = 1; // error here
   }

  2. 检查标签是否被使用（默认启用，可以通过allowUnusedLabels编译器选项禁用）

    l: // error will be reported - label `l` is unused
while (true) {
}

(x) => { x:x } // error will be reported - label `x` is unused

  3. 检查是否函数里所有带有返回值类型注解的代码路径都返回了值（默认启用，可以通过noImplicitReturns编译器选项禁用）

    // error will be reported since function does not return anything explicitly when `x` is falsy.
function test(x): number {
   if (x) return 10;
}

  4. 检查控制流是否能进到switch语句的case里（默认禁用，可以通过noFallthroughCasesInSwitch编译器选项启用）。注意没有语句的case不会被检查。

    switch(x) {
   // OK
   case 1:
   case 2:
       return 1;
}
switch(x) {
   case 1:
       if (y) return 1;
   case 2:
       return 2;
}

如果你看到了这些错误，但是你认为这时的代码是合理的话，你可以通过编译选项来阻止报错。

--module不允许与--outFile一起出现，除非 --module被指定为amd或system

之前使用模块指定这两个的时候，会生成空的out文件且不会报错。

标准库里的DOM API变动

  • ImageData.data现在的类型为Uint8ClampedArray而不是number[]。查看#949。
  • HTMLSelectElement .options现在的类型为HTMLCollection而不是HTMLSelectElement。查看#1558。
  • HTMLTableElement.createCaption，HTMLTableElement.createTBody，HTMLTableElement.createTFoot，HTMLTableElement.createTHead，HTMLTableElement.insertRow，HTMLTableSectionElement.insertRow和HTMLTableElement.insertRow现在返回HTMLTableRowElement而不是HTMLElement。查看#3583。
  • HTMLTableRowElement.insertCell现在返回HTMLTableCellElement而不是HTMLElement查看#3583。
  • IDBObjectStore.createIndex和IDBDatabase.createIndex第二个参数类型为IDBObjectStoreParameters而不是any。查看#5932。
  • DataTransferItemList.Item返回值类型变为DataTransferItem而不是File。查看#6106。
  • Window.open返回值类型变为Window而不是any。查看#6418。
  • WeakMap.clear被移除。查看#6500。

在super-call之前不允许使用this

ES6不允许在构造函数声明里访问this。

比如：

class B {
    constructor(that?: any) {}
}

class C extends B {
    constructor() {
        super(this);  // error;
    }
}

class D extends B {
    private _prop1: number;
    constructor() {
        this._prop1 = 10;  // error
        super();
    }
}
书籍推荐