可空返回类型的正确JSDoc语法是什么？

Question

使用Javascript函数JSDocs，我看到了两种不同的语法来记录可以为空的返回值。

假设我们有这个函数：

const getTitle = () => { // Can return string or null };

针对此问题，以下哪个 JSDoc 是正确的：

1. @returns {?string}（返回一个可能为空的字符串）
2. @returns [string]（返回一个字符串数组）
3. 其他？

- robertwerner_sf

---

我写了这个备忘单来帮助自己。分享出来以便有用。 - customcommander

Answer 1

你可以用两种方式来实现，第一种方式更受推荐：

@returns {?string}

@returns {string|null}

- Majed Badawi