نوع/از نسخه 1.38.0

isNil

بررسی می‌کند که آیا یک مقدار null یا undefined است و به‌عنوان type guard در TypeScript امکان محدود کردن نوع به null | undefined را فراهم می‌کند.

isNil(value):value is null | undefined

نحوه پیاده‌سازی

این تابع مقدار را با استفاده از strict equality به‌صورت مستقیم با null و undefined مقایسه می‌کند.

نوع بازگشتی `value is null | undefined` باعث می‌شود تابع یک TypeScript type guard برای مقادیر nullish باشد.

فقط null و undefined مقدار true برمی‌گردانند. سایر مقادیر falsy مانند false، صفر و رشته خالی مقدار false برمی‌گردانند.

valueunknownالزامی

مقداری که باید بررسی شود.

value is null | undefined

اگر مقدار null یا undefined باشد true و در غیر این صورت false برمی‌گرداند.

بررسی مقادیر nullish.

TypeScript

isNil(null);
// true

isNil(undefined);
// true

isNil("hello");
// false

این type guard در صورت برقرار بودن شرط، نوع مقدار بررسی‌شده را به null | undefined محدود می‌کند.

TypeScript

const value: string | null | undefined = null;

if (isNil(value)) {
  // value is narrowed to null | undefined
}

سایر مقادیر falsy مانند false، صفر و رشته خالی nil محسوب نمی‌شوند.

TypeScript

isNil(false);
// false

isNil(0);
// false

isNil("");
// false

آبجکت‌ها و آرایه‌ها nil محسوب نمی‌شوند.

TypeScript

isNil({});
// false

isNil([]);
// false

ساخته شده با@cyref/js·مستندات رسمی