CyrefJS
CCyrefJS
EN
بازگشت به مستندات
آرایه/از نسخه 1.38.0

sample

یک عنصر را به‌صورت تصادفی از یک آرایه انتخاب و برمی‌گرداند.

sample(array):T | undefined

پارامترها

arrayT[]الزامی

آرایه‌ای که باید یک عنصر تصادفی از آن انتخاب شود.

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

T | undefined

یک عنصر تصادفی از آرایه، یا در صورت خالی بودن آرایه undefined.

مثال‌ها

01

استفاده پایه

یک عنصر تصادفی را از آرایه‌ای از اعداد انتخاب می‌کند.

TypeScript
import { sample } from "@cyref/js";

const numbers = [10, 20, 30, 40, 50];

const result = sample(numbers);

console.log(result);
// One of: 10, 20, 30, 40, 50
02

با رشته‌ها

تابع می‌تواند یک عنصر را به‌صورت تصادفی از آرایه‌ای از رشته‌ها انتخاب کند.

TypeScript
import { sample } from "@cyref/js";

const languages = [
  "JavaScript",
  "TypeScript",
  "Python",
];

const result = sample(languages);

console.log(result);
// One of: "JavaScript", "TypeScript", "Python"
03

با آبجکت‌ها

تابع یک آبجکت را به‌صورت تصادفی از آرایه برمی‌گرداند.

TypeScript
import { sample } from "@cyref/js";

const users = [
  { id: 1, name: "Amir" },
  { id: 2, name: "Sara" },
  { id: 3, name: "Reza" },
];

const result = sample(users);

console.log(result);
// One of the objects from the users array
04

آرایه خالی

برای یک آرایه خالی، مقدار undefined برگردانده می‌شود.

TypeScript
import { sample } from "@cyref/js";

const result = sample([]);

console.log(result);
// undefined
ساخته شده با@cyref/js·مستندات رسمی