在谷歌应用程序脚本编辑器中自动完成并不总是知道类型/上下文

Question

我开始使用Google Apps脚本，发现自动完成非常有用。然而，一旦进入一个新函数，自动完成似乎无法知道参数的类型。我看到了一些关于python想法的答案，这些想法表明使用javadoc是可行的。但我想不通。有什么建议吗？

function myfunc1(){
  var activeSheet=SpreadsheetApp.getActiveSheet();
  activeSheet//.autocomplete works here
  myfunc2(activeSheet)
}
function myfunc2(myActiveSheet){
  myActiveSheet//.autocomplete doesn't work here
}

Answer 1

UI在自动完成方面的功能有局限性。

通常我只是在另一个选项卡中打开参考文档并引用它，但您也可以使用注释欺骗UI自动完成：

function myfunc2(myActiveSheet){
  /*
      var myActiveSheet = SpreadsheetApp.getActiveSheet()
  */
  myActiveSheet //.autocomplete now works here
}

Answer 2

新编辑器将JSDoc用于参数类型。因此，在文档中声明参数，并在大括号{}之间指定其类型。

/**
 * @param {SpreadsheetApp.Sheet} sheet
 */
function myfunc(sheet) {
  sheet //.autocomplete now works here
}