lib: include return types in JSDoc

Add types to @returns JSDoc annotations where the type is missing.

PR-URL: #41130
Reviewed-By: Michaël Zasso <[email protected]>
Reviewed-By: James M Snell <[email protected]>
Reviewed-By: Luigi Pinca <[email protected]>
Reviewed-By: Ruben Bridgewater <[email protected]>

Author: Trott

lib/internal/blob.js

@@ -129,7 +129,7 @@ class Blob {
    *   endings? : string,
    *   type? : string,
    * }} [options]
-   * @returns
+   * @constructs {Blob}
    */
   constructor(sources = [], options = {}) {
     emitExperimentalWarning('buffer.Blob');

lib/internal/fs/utils.js

@@ -525,7 +525,7 @@ Stats.prototype._checkModeProperty = function(property) {
 /**
  * @param {Float64Array | BigUint64Array} stats
  * @param {number} offset
- * @returns
+ * @returns {BigIntStats | Stats}
  */
 function getStatsFromBinding(stats, offset = 0) {
   if (isBigUint64Array(stats)) {

lib/internal/modules/esm/resolve.js

@@ -609,7 +609,7 @@ function resolvePackageTarget(packageJSONUrl, target, subpath, packageSubpath,
  * @param {Exports} exports
  * @param {URL} packageJSONUrl
  * @param {string | URL | undefined} base
- * @returns
+ * @returns {boolean}
  */
 function isConditionalExportsMainSugar(exports, packageJSONUrl, base) {
   if (typeof exports === 'string' || ArrayIsArray(exports)) return true;
@@ -724,7 +724,7 @@ function patternKeyCompare(a, b) {
  * @param {string} name
  * @param {string | URL | undefined} base
  * @param {Set<string>} conditions
- * @returns
+ * @returns {URL}
  */
 function packageImportsResolve(name, base, conditions) {
   if (name === '#' || StringPrototypeStartsWith(name, '#/')) {

lib/internal/per_context/primordials.js

@@ -404,7 +404,7 @@ primordials.PromisePrototypeCatch = (thisPromise, onRejected) =>
  * @param {Promise<any>} thisPromise
  * @param {() => void) | undefined | null} onFinally The callback to execute
  *        when the Promise is settled (fulfilled or rejected).
- * @returns A Promise for the completion of the callback.
+ * @returns {Promise} A Promise for the completion of the callback.
  */
 primordials.SafePromisePrototypeFinally = (thisPromise, onFinally) =>
   // Wrapping on a new Promise is necessary to not expose the SafePromise