mean (Lodash 兼容性)

::: warning 请使用 es-toolkit 的 mean

这个 mean 函数由于类型转换和 null/undefined 处理会运行较慢。

请使用更快、更现代的 es-toolkit 的 mean。

:::

计算数组的平均值。

typescript

const average = mean(array);

用法

`mean(array)`

计算数字数组的平均值。

typescript

import { mean } from 'es-toolkit/compat';

// 数字数组
mean([1, 2, 3, 4, 5]);
// Returns: 3

mean([10, 20, 30]);
// Returns: 20

mean([1.5, 2.5, 3.5]);
// Returns: 2.5

空数组返回 NaN。

typescript

import { mean } from 'es-toolkit/compat';

mean([]);
// Returns: NaN

mean(null);
// Returns: NaN

mean(undefined);
// Returns: NaN

无效值会被视作 0 并计算。

typescript

import { mean } from 'es-toolkit/compat';

mean([1, undefined, 2, null, 3]);
// Returns: 1.2 (1 + 2 + 3) / 5 = 1.2

字符串将会被拼接。

typescript

import { mean } from 'es-toolkit/compat';

mean(['1', '2', '3']);
// Returns: 41 (123 / 3 = 41)

参数

array (ArrayLike<any> | null | undefined): 包含要计算平均值的数字数组。

返回值

(number): 返回数组的平均值。如果是空数组则返回 NaN。