Appearance
TypeScript 1.6
完整的破坏性改动列表请到这里查看:breaking change issues。
严格的对象字面量赋值检查
当在给变量赋值或给非空类型的参数赋值时,如果对象字面量里指定的某属性不存在于目标类型中时会得到一个错误。
你可以通过使用--suppressExcessPropertyErrors编译器选项来禁用这个新的严格检查。
例子:
typescript
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`
推荐:
为了避免此错误,不同情况下有不同的补救方法:
如果目标类型接收额外的属性,可以增加一个索引:
typescript
var x: { foo: number; [x: string]: any };
x = { foo: 1, baz: 2 }; // OK, `baz` matched by index signature
如果原始类型是一组相关联的类型,使用联合类型明确指定它们的类型而不是仅指定一个基本类型。
typescript
let animalList: (Dog | Cat | Turkey)[] = [
// use union type instead of Animal
{ name: 'Milo', meow: true },
{ name: 'Pepper', bark: true },
{ name: 'koko', gobble: true },
];
还有可以明确地转换到目标类型以避免此错误:
typescript
interface Foo {
foo: number;
}
interface FooBar {
foo: number;
bar: number;
}
var y: Foo;
y = <FooBar>{ foo: 1, bar: 2 };
CommonJS 的模块解析不再假设路径为相对的
之前,对于one.ts
和two.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
typescript
export function f() {
return 10;
}
./two.ts
typescript
import { f as g } from 'one';
推荐:
修改所有计划之外的非相对的导入。
./one.ts
typescript
export function f() {
return 10;
}
./two.ts
typescript
import { f as g } from './one';
将--moduleResolution
编译器选项设置为classic
。
函数和类声明为默认导出时不再能够与在意义上有交叉的同名实体进行合并
在同一空间内默认导出声明的名字与空间内一实体名相同时会得到一个错误;比如,
typescript
export default function foo() {}
namespace foo {
var x = 100;
}
和
typescript
export default class Foo {
a: number;
}
interface Foo {
b: string;
}
两者都会报错。
然而,在下面的例子里合并是被允许的,因为命名空间并不具备做为值的意义:
typescript
export default class Foo {}
namespace Foo {}
推荐:
为默认导出声明本地变量并使用单独的export default
语句:
typescript
class Foo {
a: number;
}
interface foo {
b: string;
}
export default Foo;
更多详情,请阅读the originating issue。
模块体以严格模式解析
按照ES6 规范,模块体现在以严格模式进行解析。行为将相当于在模块作用域顶端定义了"use strict"
;它包括限制了把arguments
和eval
做为变量名或参数名的使用,把未来保留字做为变量或参数使用,八进制数字字面量的使用等。
标准库里 DOM API 的改动
- MessageEvent和ProgressEvent构造函数希望传入参数;查看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 开始,装饰器类型检查更准确了;编译器会将装饰器表达式做为以被装饰的实体做为参数的调用表达式来进行检查。这可能会造成以前的代码报错。