개요
“개요” 섹션URL 연결성, TCP 포트, WebSocket 핸드셰이크, 속도, 패킷 손실에 대한 네이티브 네트워크 진단을 실행하세요
다음으로 시작하세요 getNetworkStatus() 그리고 아래에 나열된 다른 핵심 메서드도 살펴보세요.
플랫폼 지원
“플랫폼 지원” 섹션| 플랫폼 | 지원 | 참고 사항 |
|---|---|---|
| iOS | 지원 | 네이티브 |
| Android | 지원 | 네이티브 |
| 웹 | 아니요 | Capacitor.getPlatform()으로 보호하세요 |
핵심 기능
“핵심 기능” 섹션getNetworkStatus- 네이티브 연결 유형과 플랫폼 네트워크 플래그를 읽어옵니다.testUrl- HTTP/HTTPS URL 도달 가능성, 상태 code 및 지연 시간을 확인합니다.testPort- 호스트와 포트로 네이티브 TCP 소켓을 엽니다.testWebSocket- 검증:ws://또는wss://핸드셰이크.testDownloadSpeed- 자체 테스트 파일 엔드포인트에서 네이티브 download 처리량 측정.testPacketLoss- 반복 TCP 또는 HTTP probe로 애플리케이션 레벨 패킷 손실 추정.runDiagnostics- 통합 진단 실행 후 간결한 이슈 목록 반환.
App Store 및 Play Store 앱에서는 raw ICMP ping을 일관되게 사용할 수 없어, 패킷 손실은 반복 TCP 또는 HTTP probe로 측정합니다.
공개 API
“Public API” 섹션| 메서드 | 설명 |
|---|---|
getNetworkStatus | 현재 네이티브 연결 유형과 플랫폼 네트워크 플래그 읽기. |
testUrl | 네이티브 네트워킹을 통해 HTTP 또는 HTTPS URL에 접속 가능한지 테스트합니다. |
testPort | 네이티브 네트워킹을 통해 TCP 호스트와 포트를 열 수 있는지 테스트합니다. |
testWebSocket | WebSocket URL이 네이티브 핸드셰이크를 완료할 수 있는지 테스트합니다. |
testDownloadSpeed | 네이티브 HTTP 요청의 다운로드 처리량을 측정합니다. |
testPacketLoss | 반복적인 TCP 또는 HTTP 프로브를 통해 애플리케이션 계층의 패킷 손실을 추정합니다. |
runDiagnostics | 여러 진단 항목을 실행하고 요약된 이슈 목록을 반환합니다. |
getPluginVersion | 네이티브 플러그인 버전 마커를 반환합니다. |
Source of Truth
“Source Of Truth” 섹션이 레퍼런스는 다음에서 동기화됩니다. src/definitions.ts 에서 capacitor-network-diagnostics.
