نوع/از نسخه 1.38.0

isObject

بررسی می‌کند که آیا یک مقدار یک object غیر null در جاوااسکریپت است یا نه.

isObject(value):value is object

نحوه عملکرد

تابع ابتدا null را حذف می‌کند و سپس بررسی می‌کند که آیا typeof مقدار برابر object است یا خیر. به همین دلیل آرایه‌ها و نمونه‌های داخلی مانند Date، Map و Set نیز true برمی‌گردانند.

مدیریت null

اگرچه typeof null در جاوااسکریپت برابر object است، این تابع با بررسی value !== null، مقدار null را به‌صورت صریح حذف می‌کند.

Type Guard

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

پارامترها

valueunknownالزامی

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

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

value is object

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

مثال‌ها

استفاده پایه

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

TypeScript

import { isObject } from "@cyref/js";

isObject({});
// true

isObject([]);
// true

isObject(new Date());
// true

isObject(null);
// false

isObject("hello");
// false

isObject(42);
// false

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

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

TypeScript

const value: string | object = {};

if (isObject(value)) {
  // value is object
}

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