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

isUndefined

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

isUndefined(value):value is undefined

نحوه عملکرد

این تابع از مقایسه سخت‌گیرانه (===) استفاده می‌کند تا بررسی کند مقدار ارائه‌شده دقیقاً undefined است.

تفاوت Undefined و Null

فقط مقدار undefined باعث بازگشت true می‌شود. مقدار null به‌عنوان undefined در نظر گرفته نمی‌شود.

Type Guard

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

پارامترها

valueunknownالزامی

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

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

value is undefined

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

مثال‌ها

01

استفاده پایه

بررسی اینکه مقادیر مختلف undefined هستند یا خیر.

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

isUndefined(undefined);
// true

isUndefined(null);
// false

isUndefined(0);
// false

isUndefined("");
// false

isUndefined(false);
// false
02

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

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

TypeScript
const value: string | undefined = undefined;

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