docs: add comment on utils helpers

[poolifier.git] / src / utils.ts

diff --git a/src/utils.ts b/src/utils.ts
index e56c058e5c99a292d1ac2028290ddb2c3f19752f..164a2aca5eeeec3ae86b9bfcdeeb72d872c32cb7 100644 (file)
--- a/src/utils.ts
+++ b/src/utils.ts
@@ -22,13 +22,26 @@ export const DEFAULT_WORKER_CHOICE_STRATEGY_OPTIONS: WorkerChoiceStrategyOptions
  * @returns The median of the given data set.
  */
 export const median = (dataSet: number[]): number => {
+  if (Array.isArray(dataSet) && dataSet.length === 0) {
+    return 0
+  }
   if (Array.isArray(dataSet) && dataSet.length === 1) {
     return dataSet[0]
   }
-  dataSet = [...dataSet].slice().sort((a, b) => a - b)
-  return (dataSet[(dataSet.length - 1) >> 1] + dataSet[dataSet.length >> 1]) / 2
+  const sortedDataSet = dataSet.slice().sort((a, b) => a - b)
+  return (
+    (sortedDataSet[(sortedDataSet.length - 1) >> 1] +
+      sortedDataSet[sortedDataSet.length >> 1]) /
+    2
+  )
 }
 
+/**
+ * Is the given object a plain object?
+ *
+ * @param obj - The object to check.
+ * @returns `true` if the given object is a plain object, `false` otherwise.
+ */
 export const isPlainObject = (obj: unknown): boolean =>
   typeof obj === 'object' &&
   obj !== null &&