1.38.0isBoolean
بررسی می‌کند که آیا یک مقدار از نوع boolean است و به‌عنوان type guard در TypeScript امکان محدود کردن نوع به boolean را فراهم می‌کند.
isBoolean(value):value is booleanنحوه پیاده‌سازی
این تابع با استفاده از عملگر typeof در JavaScript بررسی می‌کند که نتیجه دقیقاً برابر با "boolean" باشد.
Type guard
نوع بازگشتی `value is boolean` باعث می‌شود تابع یک TypeScript type guard باشد. زمانی که تابع true برمی‌گرداند، TypeScript می‌تواند نوع مقدار بررسی‌شده را به boolean محدود کند.
Boolean primitive
این تابع فقط مقادیر primitive یعنی true و false را شناسایی می‌کند. آبجکت‌های wrapper از نوع Boolean به‌عنوان boolean شناسایی نمی‌شوند.
پارامترها
valueunknownالزامیمقداری که باید بررسی شود.
مقدار بازگشتی
value is booleanاگر مقدار از نوع boolean باشد true و در غیر این صورت false برمی‌گرداند. در صورت true بودن، TypeScript نوع مقدار را به boolean محدود می‌کند.
مثال‌ها
استفاده پایه
بررسی اینکه یک مقدار از نوع boolean است یا خیر.
isBoolean(true);
// true
isBoolean(false);
// true
isBoolean("true");
// falseمحدود کردن نوع
این type guard مقدار unknown را داخل بلوک شرط به boolean محدود می‌کند.
const value: unknown = true;
if (isBoolean(value)) {
value.valueOf();
// value is narrowed to boolean
}سایر مقادیر primitive
اعداد، رشته‌ها، null، undefined و آبجکت‌ها boolean محسوب نمی‌شوند.
isBoolean(1);
// false
isBoolean("false");
// false
isBoolean(null);
// false
isBoolean(undefined);
// false
isBoolean({});
// falseBoolean Object
یک Boolean Object به‌عنوان boolean primitive در نظر گرفته نمی‌شود، چون typeof برای آن مقدار "object" برمی‌گرداند.
isBoolean(new Boolean(true));
// false