WebSocket.ping()

Send a ping. You can use ping messages to verify that the remote endpoint is responsive.

Example

A k6 script that initiates a WebSocket connection, sends a ping, and closes it using the onopen handler. The console should log connection is alive, since the recipient should automatically emit the pong event.

import { WebSocket } from 'k6/experimental/websockets';

export default function () {
  const ws = new WebSocket('ws://localhost:10000');

  ws.onopen = () => {
    console.log('WebSocket connection established!');
    ws.ping();
    ws.close();
  };

  ws.onpong = () => {
    // As required by the spec, when the ping is received, the recipient must send back a pong.
    console.log('connection is alive');
  };
}

The preceding example uses a WebSocket echo server, which you can run with the following command:

$ docker run --detach --rm --name ws-echo-server -p 10000:8080 jmalloc/echo-server

guides
k6 API
xk6-disruptor
jslib
Grafana Cloud k6
k6 Cloud
Extensions
Integrations
examples

Init context

k6

k6/crypto

k6/data

k6/encoding

k6/execution

k6/experimental

k6/html

k6/http

k6/metrics

k6/net/grpc

k6/ws

Error Codes

WebSocket.ping()

Example

Product

Resources

Community

About