نوع/از نسخه 1.38.0

isNumber

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

isNumber(value):value is number

نحوه عملکرد

این تابع با استفاده از typeof مقدار را بررسی می‌کند و زمانی true برمی‌گرداند که جاوااسکریپت مقدار را از نوع number تشخیص دهد. این شامل اعداد صحیح، اعشاری، Infinity، -Infinity و NaN نیز می‌شود.

Type Guard

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

مقادیر خاص Number

مقادیر NaN و Infinity توسط typeof از نوع number محسوب می‌شوند، بنابراین isNumber برای آن‌ها true برمی‌گرداند.

پارامترها

valueunknownالزامی

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

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

value is number

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

مثال‌ها

استفاده پایه

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

TypeScript

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

isNumber(42);
// true

isNumber(3.14);
// true

isNumber(NaN);
// true

isNumber("42");
// false

isNumber(null);
// false

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

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

TypeScript

const value: string | number = 42;

if (isNumber(value)) {
  // value is number
  console.log(value.toFixed(2));
}

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