İçin JSDoc wiki göre @param bir @param gösterebilir kullanarak isteğe bağlıdır

/**
    @param {String} [name]
*/
function getPerson(name) {
}

ve kullanarak satır içi bir parametre belirtebilirsiniz

function getPerson(/**String*/ name) {
}

Ve bunları aşağıdaki gibi birleştirebilirim, bu iyi çalışıyor.

/**
    @param [name]
*/
function getPerson(/**String*/name) {
}

Ama mümkünse hepsini inline yapmanın bir yolu olup olmadığını bilmek isterim.

Gönderen Resmi belgelerin :

İsteğe bağlı parametre

Foo adlı isteğe bağlı bir parametre.

@param {number} [foo]
// or:
@param {number=} foo

Varsayılan değeri 1 olan isteğe bağlı bir foo parametresi.

@param {number} [foo=1]

Biraz kazı yaptıktan sonra bunların da iyi olduğunu buldum

/**
 * @param {MyClass|undefined}
 * @param {MyClass=}
 * @param {String} [accessLevel="author"] The user accessLevel is optional.
 * @param {String} [accessLevel] The user accessLevel is optional.
 */

Şundan biraz daha görsel olarak çekici function test(/**String=*/arg) {}

Google Closure Compiler türü ifadeleri kullanarak bunu yapmanın bir yolunu buldum . Türün arkasına şu şekilde bir eşittir işareti koyarsınız: function test(/**String=*/arg) {}

İşlev bağımsız değişkenlerinde satır içi tür açıklamaları kullanıyorsanız ve bir işlev bağımsız değişkenini bu gösterimde isteğe bağlı olarak nasıl işaretleyeceğinizi merak ediyorsanız, isteğe bağlı bağımsız değişkenlere varsayılan değerler atamanın işe yaradığını buldum. Varsayılanın olmasını undefinedistiyorsanız, onu da açıkça belirlemeniz gerekir, aksi takdirde bağımsız değişken isteğe bağlı olarak işaretlenmez (önceden isteğe bağlı bağımsız değişkenler olsa bile):

function demo(
  /** @type {String} */ mandatory,
  /** @type {Number} */ optional1 = 0,
  /** @type {Number} optional2 = undefined,
)

IDE'nizin üzerine demogelirseniz, şimdi her ikisini de görmeli optional1ve optional2isteğe bağlı olarak görünmelisiniz . Bağımsız ?değişken adından sonra (TypeScript gösterimi) gösterilen VSCode'da. Sizden kaldırırsanız = undefined, optional2yalnızca optional1isteğe bağlı olduğunu göreceksiniz ki bu da tabii ki saçmadır, bu nedenle buradaki varsayılan değer yukarıdaki paragrafta ima ettiğim gibi açık olmalıdır.