Skip to content

isNil (Lodash 兼容性) ​

使用 es-toolkit 的 isNil

这个 isNil 函数由于 Lodash 兼容性的复杂处理而运行较慢。

请使用更快且现代的 es-toolkit 的 isNil。

检查值是否为 null 或 undefined。

typescript
const result = isNil(value);

用法 ​

isNil(x) ​

当您想类型安全地检查值是否为 null 或 undefined 时使用 isNil。在 TypeScript 中也可以作为类型守卫使用。

typescript
import { isNil } from 'es-toolkit/compat';

// null 和 undefined 返回 true
isNil(null); // true
isNil(undefined); // true

// 所有其他值返回 false
isNil(0); // false
isNil(''); // false
isNil(false); // false
isNil([]); // false
isNil({}); // false
isNil('hello'); // false
isNil(42); // false

与被认为是假值但不是 null 或 undefined 的值进行区分。

typescript
import { isNil } from 'es-toolkit/compat';

// 被认为是假值但不是 null/undefined 的值
isNil(0); // false
isNil(''); // false
isNil(false); // false
isNil(NaN); // false

// 只有 null 和 undefined 返回 true
isNil(null); // true
isNil(undefined); // true

参数 ​

  • x (any): 要检查是否为 null 或 undefined 的值。

返回值 ​

(x is null | undefined): 如果值为 null 或 undefined 则返回 true,否则返回 false。

采用 MIT 许可证发布。