پرش به مطلب اصلی

توابع کمکی رشته‌ها (string.ts)

توابع کمکی مربوط به کار با رشته‌ها و تولید داده‌های تصادفی.

generateString​

تولید رشته تصادفی.

function generateString(
  length = 10,
  includeNumbers = true,
  includeChars = true
): string

پارامترها:

  • length: طول رشته (پیش‌فرض: 10)
  • includeNumbers: شامل اعداد شود (پیش‌فرض: true)
  • includeChars: شامل حروف شود (پیش‌فرض: true)

بازگشتی: رشته تصادفی

مثال:

const token = generateString(32); // رشته 32 کاراکتری
const code = generateString(6, true, false); // کد 6 رقمی

stringBytesCount​

محاسبه تعداد بایت‌های رشته.

function stringBytesCount(str: string): number

پارامترها:

  • str: رشته ورودی

بازگشتی: تعداد بایت‌ها

replaceByRegex​

جایگزینی مقادیر در رشته با استفاده از regex.

function replaceByRegex(
  text: string,
  values: object,
  regex: RegExp = /:\w+/g
): string

پارامترها:

  • text: متن ورودی
  • values: شیء مقادیر جایگزین
  • regex: عبارت منظم (پیش‌فرض: /:\w+/g)

بازگشتی: متن با مقادیر جایگزین شده

مثال:

const message = replaceByRegex("Hello :name!", { name: "World" });
// نتیجه: "Hello World!"

createSlug​

ایجاد slug از رشته.

function createSlug(
  string: string,
  options: {
    lower?: boolean;
    replacement?: string;
    trim?: boolean;
    remove?: any;
    strict?: boolean;
    locale?: string;
  } = {
    replacement: "-",
    lower: false,
    strict: false,
    locale: "vi",
    trim: true,
  }
): string

پارامترها:

  • string: رشته ورودی
  • options.lower: تبدیل به lowercase
  • options.replacement: کاراکتر جایگزین space
  • options.trim: حذف space از ابتدا و انتها
  • options.remove: regex برای حذف کاراکترها
  • options.strict: حذف کاراکترهای خاص
  • options.locale: زبان

بازگشتی: slug ایجاد شده

مثال:

const slug = createSlug("Hello World!");
// نتیجه: "hello-world"

generateRandomUUID​

تولید UUID تصادفی.

function generateRandomUUID(): string

بازگشتی: UUID تصادفی

مثال:

const id = generateRandomUUID();
// نتیجه: "550e8400-e29b-41d4-a716-446655440000"