Script

• 以下限制适用于任何给定作业中使用的所有 Script 函数和外部脚本模块分配的内存：

  • 分配给脚本内存的最大字节数限制为 4MB。
  • 为堆栈分配的最大字节数限制为 64kB。
• 为避免不必要的内存分配，应从脚本中删除所有未使用的函数（例如默认示例脚本中的函数，如果不使用这些函数的话）。例如，包含生成字符串对象并绘制该对象的未使用样本绘制函数的脚本将消耗内存和 CPU 周期。

• 已声明为禁用其执行的脚本函数的功能与其他电子表格函数不同。通常，其他电子表格函数会保留该函数执行后记录的最后一个值。任何引用禁用函数的函数都将返回记录的最后一个值。但是，由于 Script 函数需要执行其内部的 run 方法，因此在加载禁用的 Script 函数时，它会显示 Script 数据结构，但任何引用它的 Get 函数将返回 #ERR，因为 Get 函数需要一个特定的返回值，而由于 Script 函数未执行，因此不会返回该值。

• 如果将单元格范围指定为参数，它将扩展到该范围中包含的单个单元格引用，因此将消耗与单元格区域中包含的相同数量的参数。
• 当脚本函数的参数是对返回 Blob、Edges、Histogram、 或 Patterns 数据结构的引用，传递给 Script 函数的对象仅在 Run 方法返回之前可用。Script 函数可以直接返回该对象，它可以作为包含 Script 函数的单元格的结果值。但是，如果脚本在内部存储此对象（例如在其 Draw 方法中使用它），则在 run 方法返回后，该对象将不可用，并且尝试调用其任何方法都会导致错误。如果脚本返回结果结构（例如 run 方法返回的脚本对象的属性），也会出现这种情况。例如，这些属性中的任何一个都不能被 Get 函数或其他 Script 函数使用，因为底层对象不再有效。

• 在编写脚本时，包括验证输入参数的代码可能有助于减少错误，如下例所示：
  

                          function Tool()
  {
  }

  module.exports = Tool;
  
  function isNumber(n) {
     if (n === undefined || n == null || isNaN(parseFloat(n)) || !isFinite(n))
        return false;
     return true;
  }
  

  Tool.prototype.run = function(x, y){
     if (!isNumber(x) || !isNumber(y))
        throw new Error("Usage: Requires 2 numeric arguments");
     return +x + +y;
  } 

Script.prototype.run = function (image, myRegion) {

return {
    x: myRegion.x,
    y: myRegion.y,
    //width: myRegion.width,
    //height: myRegion.height,
    width: myRegion.w,
    height: myRegion.h,
    angle: myRegion.angle,
    curve: myRegion.curve
};

}