networkSpeed

با چند درخواست، مقدار ping و لرزش شبکهٔ کنونی را می‌سنجد.

API

networkSpeed

بازگشت

آرگومان	توضیح	نوع
Promise<ReturnType>	Promise‌ای که با نتیجهٔ سنجش شبکه برآورده می‌شود	Promise

ReturnType

ویژگی	توضیح	نوع
ping	میانگین مقدار ping (میلی‌ثانیه)	number
jitter	لرزش شبکه (میلی‌ثانیه)	number

پارامترها

پارامتر	توضیح	نوع	پیش‌فرض
options	گزینه‌های پیکربندی	Options	الزامی

گزینه‌ها

پارامتر	توضیح	نوع	پیش‌فرض
url	نشانی تصویری که با آن سنجیده می‌شود	string	الزامی
duration	فاصلهٔ میان درخواست‌ها (میلی‌ثانیه)	number	3000
count	شمار سنجش‌ها	number	5

نمونه

کاربرد پایه

import { networkSpeed } from 'ranuts';

const result = await networkSpeed({
  url: 'https://example.com/test.jpg',
  count: 5,
  duration: 3000,
});

console.log('میانگین تأخیر:', result.ping, 'ms');
console.log('لرزش شبکه:', result.jitter, 'ms');

برآورد کیفیت شبکه

import { networkSpeed } from 'ranuts';

async function assessNetwork() {
  const { ping, jitter } = await networkSpeed({ count: 10, url: 'https://example.com/test.jpg' });

  if (ping < 50 && jitter < 20) {
    console.log('کیفیت شبکه عالی است');
  } else if (ping < 100 && jitter < 50) {
    console.log('کیفیت شبکه خوب است');
  } else {
    console.log('کیفیت شبکه متوسط است');
  }
}

تغییر پارامترهای سنجش

import { networkSpeed } from 'ranuts';

// ده بار سنجش، هر بار با دو ثانیه فاصله
const result = await networkSpeed({
  url: 'https://example.com/ping.jpg',
  count: 10,
  duration: 2000,
});

یادداشت‌ها

1. لرزش: نوسان شبکه را نشان می‌دهد؛ اختلاف بیشترین و کمترین مقدار در چند سنجش، و هرچه کمتر، شبکه پایدارتر.
2. شیوهٔ سنجش: چند درخواست تصویر می‌فرستد و میانگین تأخیر و لرزش را حساب می‌کند.
3. مقدارهای پیش‌فرض: پنج سنجش با فاصلهٔ سه ثانیه.
4. کاربرد: معمولاً برای سنجش کیفیت شبکه، پایش کارایی و بهبود تجربهٔ کاربر به کار می‌رود.