Что означает восклицательный знак в комментариях javascript @param и @return? - PullRequest
1 голос
/ 02 мая 2020

Я пытаюсь следовать этому руководству :

/** A class that does something. */
class SomeClass extends SomeBaseClass {
  /**
   * Operates on an instance of MyClass and returns something.
   * @param {!MyClass} obj An object that for some reason needs detailed
   *     explanation that spans multiple lines.
   * @param {!OtherClass} obviousOtherClass
   * @return {boolean} Whether something occurred.
   */
  someMethod(obj, obviousOtherClass) { ... }

  /** @override */
  overriddenMethod(param) { ... }
}

/**
 * Demonstrates how top-level functions follow the same rules.  This one
 * makes an array.
 * @param {TYPE} arg
 * @return {!Array<TYPE>}
 * @template TYPE
 */
function makeArray(arg) { ... }

, и я хочу знать, что означает восклицательный знак в @param {!MyClass} или @return {!Array<TYPE>} и когда использовать это.

1 Ответ

2 голосов
/ 02 мая 2020

В соответствии с таблицей на Используйте JSDo c: @ type , в строке для "Non-Nullable Type" предыдущий восклицательный знак означает "ненулевой" .

...