Skip to content

Latest commit

 

History

History
177 lines (117 loc) · 5.29 KB

typescript-1.6.md

File metadata and controls

177 lines (117 loc) · 5.29 KB

TypeScript 1.6

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

严格的对象字面量赋值检查

当在给变量赋值或给非空类型的参数赋值时,如果对象字面量里指定的某属性不存在于目标类型中时会得到一个错误。

你可以通过使用--suppressExcessPropertyErrors编译器选项来禁用这个新的严格检查。

例子:

var x: { foo: number };
x = { foo: 1, baz: 2 }; // Error, excess property `baz`

var y: { foo: number; bar?: number };
y = { foo: 1, baz: 2 }; // Error, excess or misspelled property `baz`

推荐:

为了避免此错误,不同情况下有不同的补救方法:

如果目标类型接收额外的属性,可以增加一个索引:

var x: { foo: number; [x: string]: any };
x = { foo: 1, baz: 2 }; // OK, `baz` matched by index signature

如果原始类型是一组相关联的类型,使用联合类型明确指定它们的类型而不是仅指定一个基本类型。

let animalList: (Dog | Cat | Turkey)[] = [
  // use union type instead of Animal
  { name: 'Milo', meow: true },
  { name: 'Pepper', bark: true },
  { name: 'koko', gobble: true },
];

还有可以明确地转换到目标类型以避免此错误:

interface Foo {
  foo: number;
}
interface FooBar {
  foo: number;
  bar: number;
}
var y: Foo;
y = <FooBar>{ foo: 1, bar: 2 };

CommonJS 的模块解析不再假设路径为相对的

之前,对于one.tstwo.ts文件,如果它们在相同目录里,那么在two.ts里面导入"one"时是相对于one.ts的路径的。

TypeScript 1.6 在编译 CommonJS 时,"one"不再等同于"./one"。取而代之的是会相对于合适的node_modules文件夹进行查找,与 Node.js 在运行时解析模块相似。更多详情,阅读the issue that describes the resolution algorithm

例子:

./one.ts

export function f() {
  return 10;
}

./two.ts

import { f as g } from 'one';

推荐:

修改所有计划之外的非相对的导入。

./one.ts

export function f() {
  return 10;
}

./two.ts

import { f as g } from './one';

--moduleResolution编译器选项设置为classic

函数和类声明为默认导出时不再能够与在意义上有交叉的同名实体进行合并

在同一空间内默认导出声明的名字与空间内一实体名相同时会得到一个错误;比如,

export default function foo() {}

namespace foo {
  var x = 100;
}

export default class Foo {
  a: number;
}

interface Foo {
  b: string;
}

两者都会报错。

然而,在下面的例子里合并是被允许的,因为命名空间并不具备做为值的意义:

export default class Foo {}

namespace Foo {}

推荐:

为默认导出声明本地变量并使用单独的export default语句:

class Foo {
  a: number;
}

interface foo {
  b: string;
}

export default Foo;

更多详情,请阅读the originating issue

模块体以严格模式解析

按照ES6 规范,模块体现在以严格模式进行解析。行为将相当于在模块作用域顶端定义了"use strict";它包括限制了把argumentseval做为变量名或参数名的使用,把未来保留字做为变量或参数使用,八进制数字字面量的使用等。

标准库里 DOM API 的改动

  • MessageEventProgressEvent构造函数希望传入参数;查看issue #4295
  • ImageData构造函数希望传入参数;查看issue #4220
  • File构造函数希望传入参数;查看issue #3999

系统模块输出使用批量导出

编译器以系统模块的格式使用新的_export函数批量导出的变体,它接收任何包含键值对的对象做为参数而不是 key, value。

模块加载器需要升级到v0.17.1或更高。

npm 包的.js 内容从'bin'移到了'lib'

TypeScript 的 npm 包入口位置从bin移动到了lib,以防‘node_modules/typescript/bin/typescript.js’通过 IIS 访问的时候造成阻塞(bin默认是隐藏段因此 IIS 会阻止访问这个文件夹)。

TypeScript 的 npm 包不会默认全局安装

TypeScript 1.6 从 package.json 里移除了preferGlobal标记。如果你依赖于这种行为,请使用npm install -g typescript

装饰器做为调用表达式进行检查

从 1.6 开始,装饰器类型检查更准确了;编译器会将装饰器表达式做为以被装饰的实体做为参数的调用表达式来进行检查。这可能会造成以前的代码报错。