نوع/از نسخه 1.38.0

isString

بررسی می‌کند که آیا یک مقدار از نوع primitive string است یا نه.

isString(value):value is string

نحوه عملکرد

این تابع با استفاده از typeof مقدار را بررسی می‌کند و فقط زمانی true برمی‌گرداند که جاوااسکریپت مقدار را از نوع primitive string تشخیص دهد.

رشته‌های Primitive

String literalها و مقادیر primitive از نوع string مقدار true برمی‌گردانند. اشیایی مانند new String("hello") به دلیل اینکه typeof آن‌ها object است، true برنمی‌گردانند.

Type Guard

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

پارامترها

valueunknownالزامی

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

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

value is string

اگر مقدار از نوع string در جاوااسکریپت باشد true و در غیر این صورت false برمی‌گرداند.

مثال‌ها

استفاده پایه

بررسی اینکه مقادیر مختلف از نوع string هستند یا خیر.

TypeScript

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

isString("hello");
// true

isString("");
// true

isString("123");
// true

isString(123);
// false

isString(null);
// false

isString(undefined);
// false

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

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

TypeScript

const value: string | number = "hello";

if (isString(value)) {
  console.log(value.toUpperCase());
}

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