isString

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

API

isString

بازگشت

آرگومان	توضیح	نوع
boolean	اینکه رشته هست یا نه	boolean

پارامترها

پارامتر	توضیح	نوع	پیش‌فرض
obj	مقداری که بررسی می‌شود	unknown	الزامی

نمونه

کاربرد پایه

import { isString } from 'ranuts';

console.log(isString('hello')); // true
console.log(isString(123)); // false
console.log(isString(null)); // false
console.log(isString(undefined)); // false

بررسی نوع

import { isString } from 'ranuts';

function processValue(value) {
  if (isString(value)) {
    console.log('رشته است:', value.toUpperCase());
  } else {
    console.log('رشته نیست');
  }
}

processValue('hello'); // 'رشته است: HELLO'
processValue(123); // 'رشته نیست'

وارسی آرگومان‌ها

import { isString } from 'ranuts';

function validateInput(input) {
  if (!isString(input)) {
    throw new Error('ورودی باید رشته باشد');
  }
  return input.trim();
}

یادداشت‌ها

1. تشخیص نوع: از Object.prototype.toString.call() استفاده می‌کند و نوع را دقیق تشخیص می‌دهد.
2. سخت‌گیری: تنها زمانی true برمی‌گرداند که مقدار واقعاً از نوع رشته باشد؛ بقیهٔ نوع‌ها (از جمله شیء String) false می‌دهند.
3. کاربرد: معمولاً برای بررسی نوع، وارسی آرگومان‌ها و مانند آن به کار می‌رود.