roblox-ts 是一个面向 Roblox 的 TypeScript 到 Luau 转译器。它让开发者以 TypeScript 语法编写 Roblox 游戏逻辑,但需明确:这是“Roblox 加 TypeScript 语法”,而非完整的 JavaScript 环境,许多 JavaScript API 在其中并不存在。资料基于 roblox-ts v3.0.0。
用途:在编写 Roblox 的 TypeScript 代码时提供参考,尤其是当你不确定某个 JavaScript API 是否可用,或需要处理与 Luau 的互操作时。
主要能力与参考内容:
核心参考部分包含四个主题。JavaScript 差异:说明缺失的 API、assert() 的真值性、any 类型与 typeof 等行为差异。类型检查:介绍 typeIs、classIs 以及 RemoteEvent 校验。构造函数:说明 new 语法、DataType 的数学运算(.add/.sub)与集合相关用法。工具类型:涵盖 satisfies、InstancePropertyNames、Services、ExtractKeys。
功能部分包含两个主题。Luau 互操作:介绍 $tuple、LuaTuple、类型声明以及回调与方法的区别。游戏层级:说明如何使用 services.d.ts 为 Workspace 的子项标注类型。
使用方式:资料仅给出上述参考主题与基于 roblox-ts v3.0.0 的说明,未提供具体安装命令、配置步骤或代码示例,相关内容暂未提供。
适用场景:使用 TypeScript 开发 Roblox 项目;需要确认 JavaScript API 在 roblox-ts 中是否存在;需要处理 TypeScript 与 Luau 之间的类型与调用互操作;需要为 Roblox 游戏层级对象补充类型声明。
限制:roblox-ts 并非完整 JavaScript 运行时,部分 JavaScript API 缺失;assert() 的真值性、any 类型与 typeof 等行为与标准 JavaScript 存在差异,需按资料中的差异说明处理。具体安装方法、版本兼容细节与完整 API 列表暂未提供。