Làm thế nào để chỉ ra param là tùy chọn bằng cách sử dụng JSDoc nội dòng?

Question

Theo wiki JSDoc cho @param bạn có thể chỉ ra một @ param là không bắt buộc sử dụng

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

và bạn có thể chỉ ra một param inline sử dụng

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

Và tôi có thể kết hợp chúng như sau, trong đó hoạt động ok.

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

Nhưng tôi muốn biết liệu có cách nào để làm tất cả nội dòng nếu có thể.

Answer 1

Tôi đã tìm thấy cách để thực hiện việc này bằng Trình biên dịch đóng cửa của Google type expressions. Bạn đặt một dấu bằng sau kiểu như vậy: function test(/**String=*/arg) {}

Answer 2

Sau khi một số đào lên tôi thấy đây là ok cũng

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

Chỉ cần nhẹ hơn trực quan hấp dẫn hơn function test(/**String=*/arg) {}

Answer 3

Từ official documentation:

Tham số tùy chọn

Thông số tùy chọn có tên là foo.

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

Một tham số foo tùy chọn có giá trị mặc định 1.

@param {number} [foo=1]