如何在 CoffeeScript 中为 Google Apps 脚本生成全局命名 JavaScript 函数

Question

我想使用 CoffeeScript 为 Google Apps 脚本 编写 Javascript 脚本，并且我正在使用无法生成预期形式的函数。

Google Apps 脚本期望脚本包含顶级命名函数。 （我可能使用了错误的术语，所以我将用示例来说明我的意思...）

例如，这个函数很高兴被 Google Apps 脚本识别：

function triggerableFunction() {
   // ...
}

...而这个函数不是（它会解析，但是你不会无法触发它吗？）：

var nonTriggerableFunction;

nonTriggerableFunction = function() {
  // ...
};

我发现使用 CoffeeScript，我能得到的最接近的是上面的 nonTriggerableFunction 形式。生成像上面的 triggerableFunction 这样的命名函数的最佳方法是什么？

我已经使用“裸”选项（-b 开关）来编译 没有顶级函数安全包装器。

我在网上发现的一个结合了 CoffeeScript 和 Google App Script 的项目是 Gmail GTD Bot，它似乎使用反引号的组合来完成此操作，并要求用户从结果代码中手动删除一些行。 （请参阅脚本的末尾，以及README 的“安装”部分）。我希望有一个更简单、更干净的解决方案。

Answer 1

CoffeeScript 不允许您在全局命名空间中隐式创建任何内容；但是，您可以通过直接指定全局命名空间来做到这一点。

window.someFunc = (someParam) -> 
    alert(someParam)

Answer 2

事实证明，这可以通过为每个函数使用一行 嵌入式 Javascript 来完成。

例如

myNonTriggerableFunction = ->
  Logger.log("Hello World!")

`function myTriggerableFunction() { myNonTriggerableFunction(); }`

，当使用“bare”选项（-b 开关）调用咖啡编译器时，此 CoffeeScript： ... 将生成此 JavaScript：

var myNonTriggerableFunction;

myNonTriggerableFunction = function() {
  return Logger.log("Hello World!");
};

function myTriggerableFunction() { myNonTriggerableFunction(); };

通过上面的示例，Google Apps 脚本能够触发 myTriggerableFunction直接地。

Answer 3

这应该给你一个全局命名函数（是的，这有点hacky，但远不如使用反引号）：

# wrap in a self invoking function to capture global context
do ->
  # use a class to create named function
  class @triggerableFunction
    # the constructor is invoked at instantiation, this should be the function body
    constructor: (arg1, arg2) ->
      # whatever

Answer 4

只需在脚本中使用@，我的代码示例：

@isArray = (o)->
  Array.isArray(o)

它将被编译为：

(function() {

  this.isArray = function(o) {
    return Array.isArray(o);
  };

}).call(this);

this = window 在这种情况下，所以它是全局函数