TypeScript 功能

【TypeScript features】

由于 Node.js 仅移除内联类型，任何涉及用新的 JavaScript 语法替换 TypeScript 语法的 TypeScript 特性都会出错，除非传递了标志 --experimental-transform-types。

【Since Node.js is only removing inline types, any TypeScript features that involve replacing TypeScript syntax with new JavaScript syntax will error, unless the flag --experimental-transform-types is passed.】

需要转换的最突出的功能是：

【The most prominent features that require transformation are:】

• Enum 声明
• namespace 与运行时代码
• 带有运行时代码的传统 module
• 参数属性
• 导入别名

不包含运行时代码的 namespaces 和 module 是被支持的。这个示例将会正确运行：

// This namespace is exporting a type
namespace TypeOnly {
   export type A = string;
} 拷贝

这将导致 ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX 错误：

【This will result in ERR_UNSUPPORTED_TYPESCRIPT_SYNTAX error:】

// This namespace is exporting a value
namespace A {
   export let x = 1
} 拷贝

由于装饰器目前是一个 TC39 第3阶段提案，并且很快将得到 JavaScript 引擎的支持，所以它们不会被转换，并且会导致解析器错误。这是一个临时限制，未来将会得到解决。

【Since Decorators are currently a TC39 Stage 3 proposal and will soon be supported by the JavaScript engine, they are not transformed and will result in a parser error. This is a temporary limitation and will be resolved in the future.】

此外，Node.js 不会读取 tsconfig.json 文件，也不支持依赖 tsconfig.json 设置的功能，例如路径或将较新的 JavaScript 语法转换为较旧的标准。

【In addition, Node.js does not read tsconfig.json files and does not support features that depend on settings within tsconfig.json, such as paths or converting newer JavaScript syntax into older standards.】