语言支持

• 不会被读取。每个项目都隐含着如下选项：

  隐含的 isolatedModules 选项意味着：

  • 不支持 const enums。

  • 重导出 TypeScript 类型和接口时应该使用 export type。例如使用 export type { Foo } from './foo'; 而不是 export { Foo } from './foo';。

• 不支持 export = 和 import =。

• 编译过程中的类型错误将被忽略。

编译时不会读取 ，意味着 tsconfig.json 的编译选项并不会影响编译。

开发者仍然可以在项目中使用 tsconfig.json 以配合 IDE 实现类型检查等功能。为了让 IDE 的 TypeScript 检查功能和 Creator 行为兼容，开发者需要额外注意一些事项，详情可参考 。

• Cocos Creator 3.0 TypeScript 问题答疑及经验分享
• TypeScript - Classes
• TypeScript - DefinitelyTyped
• TypeScript 源码

JavaScript

Creator 支持的 JavaScript 语言规范为 ES6。

此外，以下几项更新于 ES6 规范的语言特性或提案仍旧在支持之列：

• 可选链操作符 ?.
• 逻辑赋值操作符
  • 逻辑空赋值操作符 ??=
  • 逻辑或赋值操作符 ||=

以下语言特性同样支持，但需要开启相关的编译选项：

• 异步函数

Creator 开放了部分编译选项，这些选项将应用到整个项目。

从用户的角度来说，Creator 未绑定任何 JavaScript 实现，因此建议开发者严格依照 JavaScript 规范编写脚本，以获取更好的跨平台支持。

举例来说，当希望使用 全局对象 时，应当使用标准特性 globalThis：

而非 window、global、self 或 this：

再如，Creator 未提供 CommonJS 的模块系统，因此以下代码片段会带来问题：

反之，应使用标准模块语法：

• JavaScript 秘密花园