Improve a bit JSDoc.

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

diff --git a/src/charging-station/ocpp/OCPPRequestService.ts b/src/charging-station/ocpp/OCPPRequestService.ts
index 290316ccd748b7938bb24b33f3e0e8d31481f0da..5615eb7705411c04f3054e07b2e1ed4daa0628e8 100644 (file)
--- a/src/charging-station/ocpp/OCPPRequestService.ts
+++ b/src/charging-station/ocpp/OCPPRequestService.ts
@@ -72,8 +72,8 @@ export default abstract class OCPPRequestService {
       /**
        * Function that will receive the request's response
        *
-       * @param payload
-       * @param requestPayload
+       * @param {Record<string, unknown> | string} payload
+       * @param {Record<string, unknown>} requestPayload
        */
       async function responseCallback(payload: Record<string, unknown> | string, requestPayload: Record<string, unknown>): Promise<void> {
         if (self.chargingStation.getEnableStatistics()) {
@@ -87,7 +87,7 @@ export default abstract class OCPPRequestService {
       /**
        * Function that will receive the request's rejection
        *
-       * @param error
+       * @param {OCPPError} error
        */
       function rejectCallback(error: OCPPError): void {
         if (self.chargingStation.getEnableStatistics()) {

diff --git a/src/utils/Utils.ts b/src/utils/Utils.ts
index e4bc6a7b723f89ff593fff7dee1f9aba97ce2a74..25ac7634e28f3c4584d4fecda288be0de2f6387d 100644 (file)
--- a/src/utils/Utils.ts
+++ b/src/utils/Utils.ts
@@ -183,8 +183,8 @@ export default class Utils {
   static insertAt = (str: string, subStr: string, pos: number): string => `${str.slice(0, pos)}${subStr}${str.slice(pos)}`;
 
   /**
-   * @param  {number} [retryNumber=0]
-   * @returns {number} - delay in milliseconds
+   * @param {number} [retryNumber=0]
+   * @returns {number} delay in milliseconds
    */
   static exponentialDelay(retryNumber = 0): number {
     const delay = Math.pow(2, retryNumber) * 100;
@@ -192,6 +192,12 @@ export default class Utils {
     return delay + randomSum;
   }
 
+  /**
+   * Convert websocket error code to human readable string message
+   *
+   * @param {number} code websocket error code
+   * @returns {string} human readable string message
+   */
   static getWebSocketCloseEventStatusString(code: number): string {
     if (code >= 0 && code <= 999) {
       return '(Unused)';

diff --git a/src/worker/WorkerAbstract.ts b/src/worker/WorkerAbstract.ts
index 6a8a0a0ff07dc9003816ea6f76ef9e356d22a1de..9f16af737457cf5daa522a1d25859514a6b6b3b1 100644 (file)
--- a/src/worker/WorkerAbstract.ts
+++ b/src/worker/WorkerAbstract.ts
@@ -6,7 +6,7 @@ export default abstract class WorkerAbstract {
   public abstract maxElementsPerWorker: number;
 
   /**
-   * Create a new `Worker` implementation.
+   * `WorkerAbstract` constructor.
    *
    * @param {string} workerScript
    */

diff --git a/src/worker/WorkerDynamicPool.ts b/src/worker/WorkerDynamicPool.ts
index eb570887f43d8df927b8310d9fb3166740f1f1c8..a9aa56f09765912a3a4193bb8acc299654d1d3a2 100644 (file)
--- a/src/worker/WorkerDynamicPool.ts
+++ b/src/worker/WorkerDynamicPool.ts
@@ -13,8 +13,8 @@ export default class WorkerDynamicPool<T> extends WorkerAbstract {
    * Create a new `WorkerDynamicPool`.
    *
    * @param {string} workerScript
-   * @param min
-   * @param max
+   * @param {number} min
+   * @param {number} max
    */
   constructor(workerScript: string, min: number, max: number,) {
     super(workerScript);

diff --git a/src/worker/WorkerSet.ts b/src/worker/WorkerSet.ts
index bda3018bf9a2df631dd9057dc6647844ebbf03f3..bf8b70210cc289efd0db0e631b12cf72d7099e4a 100644 (file)
--- a/src/worker/WorkerSet.ts
+++ b/src/worker/WorkerSet.ts
@@ -69,7 +69,6 @@ export default class WorkerSet<T> extends WorkerAbstract {
 
   /**
    *
-   * @returns {Promise}
    * @private
    */
   private startWorker(): void {

diff --git a/src/worker/WorkerStaticPool.ts b/src/worker/WorkerStaticPool.ts
index 97664dbae58ddb378aa03239610f6b68dcac056e..6421762918cc1ce9986a277cb1e46e58a5e16ccc 100644 (file)
--- a/src/worker/WorkerStaticPool.ts
+++ b/src/worker/WorkerStaticPool.ts
@@ -13,7 +13,7 @@ export default class WorkerStaticPool<T> extends WorkerAbstract {
    * Create a new `WorkerStaticPool`.
    *
    * @param {string} workerScript
-   * @param numberOfThreads
+   * @param {number} numberOfThreads
    */
   constructor(workerScript: string, numberOfThreads: number) {
     super(workerScript);