Ping
Function: PING
The PING function sends an ICMP ping to a given host to verify network reachability and responsiveness from the test device.
The step reports round-trip time, jitter and packet loss. Mobile data is switched on first.
Supported on: Android only.
Prerequisite
The NetDiag app (com.netdiag.app) must be installed on the phone. Without it the step fails.
Parameters¶
| Parameter Name | Description | Example Values | Required | Default Value |
|---|---|---|---|---|
HOST |
The host to ping — a hostname or IP address. An http:// or https:// prefix is removed. |
8.8.8.8, google.com | Yes | |
TIMEOUT |
The maximum time to wait for a response, in seconds. Whole seconds, 0-3700. | 5, 10, 30 | Yes | |
EXPECT |
The expected result of the ping. SUCCESS when the host responds, FAIL when it should not. |
SUCCESS, FAIL |
Yes | SUCCESS |
Explanation of Fields¶
- HOST: The target host the device will ping (hostname or IP address).
- TIMEOUT: How long to wait for a reply before the step times out, in seconds.
- EXPECT: Defines the expected outcome —
SUCCESSif the host is reachable,FAILif it should be unreachable.