isNil

値がnullまたはundefinedであるかを確認します。

const result = isNil(value);

参照

isNil(value)

値がnullやundefinedであるかを確認したい場合は、isNilを使用してください。

import { isNil } from 'es-toolkit/predicate';

// null または undefined の値
console.log(isNil(null)); // true
console.log(isNil(undefined)); // true

// その他の値
console.log(isNil(0)); // false
console.log(isNil('')); // false
console.log(isNil(false)); // false
console.log(isNil([])); // false
console.log(isNil({})); // false

TypeScriptの型ガードとしても使用できます：

function processValue(value: string | null | undefined) {
  if (isNil(value)) {
    // valueはnull | undefined型に絞り込まれます
    console.log('値が空です');
  } else {
    // valueはstring型に絞り込まれます
    console.log(value.toUpperCase());
  }
}

パラメータ

• value (unknown): nullまたはundefinedであるかを確認する値です。

戻り値

(value is null | undefined): 値がnullまたはundefinedの場合はtrue、そうでない場合はfalseを返します。