语言支持
- TypeScript
  - TypeScript 参考教程
- JavaScript

语言支持

Cocos Creator 支持 TypeScript 和 JavaScript 两种编程语言。但需要注意的是，JavaScript 只支持以插件脚本的形式导入使用。

TypeScript

Cocos Creator 支持 TypeScript 4.1.0。在此基础上，做了以下限制：

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

{
  "compilerOptions": {
      "target": "ES2015",
      "module": "ES2015",
      "isolatedModules": true,
      "experimentalDecorators": true,
      "moduleResolution": /* Cocos Creator 特定的模块解析算法 */,
      "forceConsistentCasingInFileNames": true,
  }
}

隐含的 isolatedModules 选项意味着：

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

不支持 export = 和 import =。
命名空间导出的变量必须声明为 const，而不是 var 或 let。
同一命名空间的不同声明不会共享作用域，需要显式使用限定符。
编译过程中的类型错误将被忽略。

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

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

TypeScript 参考教程

JavaScript

语言特性

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

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

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

异步函数

特别地，Creator 目前支持 Legacy 装饰器提案，其具体用法和含义请参考 babel-plugin-proposal-decorators。由于该提案仍处于阶段 2，引擎暴露的所有装饰器相关功能接口都在以下划线开头的 _decorator 命名空间下。

编译选项

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

选项	名称	含义
useDefineForClassFields	符合规范的类字段	当开启时，将使用 `Define` 语义实现类字段，否则将使用 `Set` 语义实现类字段。仅当目标不支持 ES6 类字段时生效。
allowDeclareFields	允许声明类字段	当开启时，在 TypeScript 脚本中将允许使用 `declare` 关键字来声明类字段，并且，当字段未以 `declare` 声明且未指定显式的初始化式时，将依照规范初始化为 `undefined`。

运行环境

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

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

globalThis.blahBlah // 任何环境下 globalThis 一定存在

而非 window、global、self 或 this：

typeof window // 可能是 'undefined'
typeof global // 在浏览器环境下可能是 'undefined'

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

const blah = require('./blah-blah'); // 错误，require 是未定义的
module.exports = blah; // 错误 module 是未定义的

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

import blah from './blah-blah';
export default blah;

编程语言支持