GAS网页编辑器类型标注是特性还是bug？如何使用类型提示功能？

底层逻辑说明 #

你观测到的表现既不是官方特性也不是bug，本质是GAS网页编辑器底层采用了和VS Code一致的Monaco编辑器组件，该组件原生自带TypeScript语法识别、类型推导和自动补全能力，但是GAS服务端运行环境本身不提供TypeScript编译转译能力，二者的能力差导致了你碰到的所有现象：

• Monaco编辑器可以识别你写的TS类型标注，所以可以基于标注推导变量类型，给出字符串方法、GAS官方库的补全提示；同时编辑器知道TS类型标注不是合法的原生JavaScript语法，所以会给出红色波浪线提示，且提供TS忽略相关的快捷选项
• GAS的V8/Rhino运行时只会直接解析执行纯JavaScript代码，不会处理TS语法，所以类型标注里的:会被识别为非法字符，直接触发运行时语法错误

网页编辑器中合法使用类型标注的方案 #

GAS官方原生支持JSDoc格式的类型标注，不需要引入TS语法，不会触发运行错误，同时可以触发编辑器的类型推导、自动补全能力，是网页端开发的首选方案：

示例代码：

/**
 * 测试函数
 * @param {string} text 输入的字符串参数
 * @param {number} count 计数参数
 * @returns {string} 拼接后的结果
 */
function helloWorld(text, count) {
  // 输入text.会自动弹出所有String类方法提示
  return text.repeat(count);
}

如果你坚持要使用TS语法的类型标注，只能通过本地clasp工具开发，先将TS代码转译为纯JS后再推送至GAS项目，无法直接在网页编辑器内完成开发、运行流程。

内容的提问来源于stack exchange，提问作者Walker