networkSpeed

요청을 여러 번 보내 지금 네트워크의 ping 값과 흔들림을 잽니다.

API

networkSpeed

반환값

인자	설명	타입
`Promise<ReturnType>`	네트워크 측정 결과로 이행되는 Promise	`Promise`

ReturnType

프로퍼티	설명	타입
`ping`	평균 ping 값(밀리초)	`number`
`jitter`	네트워크 흔들림(밀리초)	`number`

매개변수

매개변수	설명	타입	기본값
`options`	설정 옵션	`Options`	필수

옵션

매개변수	설명	타입	기본값
`url`	측정에 쓸 이미지 URL	`string`	필수
`duration`	요청 사이의 간격(ms)	`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';

// 2초 간격으로 열 번 잽니다
const result = await networkSpeed({
  url: 'https://example.com/ping.jpg',
  count: 10,
  duration: 2000,
});

참고

흔들림: 네트워크가 얼마나 요동치는지를 나타냅니다. 여러 번 잰 값 가운데 최댓값과 최솟값의 차이이며, 작을수록 네트워크가 안정적입니다.
재는 방식: 이미지 요청을 여러 번 보내 평균 지연과 흔들림을 구합니다.
기본 조건: 3초 간격으로 다섯 번 잽니다.
활용: 네트워크 품질 판단, 성능 관찰, 사용 경험 다듬기 등에 흔히 쓰입니다.