CyrefJS
CCyrefJS
EN
بازگشت به مستندات
نوع/از نسخه 1.38.0

isNull

بررسی می‌کند که آیا یک مقدار دقیقاً null است یا نه.

isNull(value):value is null

نحوه عملکرد

این تابع از مقایسه سخت‌گیرانه (===) استفاده می‌کند تا بررسی کند مقدار دقیقاً null است. برخلاف بررسی‌های غیرسخت‌گیرانه، undefined به‌عنوان null در نظر گرفته نمی‌شود.

Type Guard

نوع خروجی value is null است و به TypeScript اجازه می‌دهد داخل شرط، نوع مقدار را به null محدود کند.

پارامترها

valueunknownالزامی

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

مقدار بازگشتی

value is null

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

مثال‌ها

01

استفاده پایه

بررسی اینکه یک مقدار null است یا خیر.

TypeScript
import { isNull } from "@cyref/js";

isNull(null);
// true

isNull(undefined);
// false

isNull(0);
// false

isNull("");
// false
02

محدود کردن نوع

isNull یک Type Guard در TypeScript است و در صورت true شدن، نوع مقدار را به null محدود می‌کند.

TypeScript
const value: string | null = null;

if (isNull(value)) {
  // value is null
}
ساخته شده با@cyref/js·مستندات رسمی