Skip to content

isNil (Lodash 兼容性)

使用 es-toolkit 的 isNil

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

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

检查值是否为 nullundefined

typescript
const result = isNil(value);

参考

isNil(x)

当您想类型安全地检查值是否为 nullundefined 时使用 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

与被认为是假值但不是 nullundefined 的值进行区分。

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): 要检查是否为 nullundefined 的值。

返回值

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

采用 MIT 许可证发布。