使用Closure Compiler JsDoc注释替换源代码中的测试？

Question

JSDoc注释是否足以测试参数的有效性？

示例：在以下“添加”方法中，参数（点对象）被定义为非空点类型。 然后，在这种方法中并使用Closure Compiler，我可以跳过测试该参数值所需的代码：

1. if (!point) {...
2. if (!(point instanceof Point)) {...

谢谢

class Point{
  /**
   * Add x/y values to the Point object
   *
   * @param {!Point} point The x/y values to add.
   *
   */
  add(point) {
    this.x += point.x;
    this.y += point.y;
  }
}

Answer 1

是的，前提是正在编译任何调用该方法的代码。

如果您有代码调用未编译的方法，则编译器无法保证传递的类型。 例如，如果您要使一个库由未编译的代码调用。 在这种情况下，您可能要导出add方法，以使其可以被外部未编译的代码访问。

如果不导出add方法，则只有编译后的代码可以访问它。

请参阅《 封闭式 Michael Bolin 权威指南》中第408页的“ 由编译器提供的检查 ”部分。 您需要为编译器指定某些标志，例如：

--jscomp_error=checkTypes
--warning_level=VERBOSE