JSDoc：如何記錄類型為 Object 或 null？

Question

如果我有一個類型為 Object 或 null 的參數，我應該將其記錄為 {Object} 或 {?Object} 還是 {Object|null}？

我讀到https://jsdoc.app/tags-type.html它說 {?number} 表示數字或 null，但我不確定是否需要這個原語，或者只是我不確定。

Answer 1

在 javascript 中，您可以使用像element?.addEventListener()這樣的optional chaining來檢查 null 與否。 因此，正因為如此，{?Object} 更直觀。 只要確保它實際上接受null而不是undefined 。 它們有不同的含義。