Documentation for automated readers
A curated documentation index is available at: https://grafana.com/llms.txt
A complete documentation index is available at: https://grafana.com/llms-full.txt
These indexes can help with page discovery before fetching individual documents.
This page is also available in Markdown, which may be easier for automated readers and AI tools to parse than HTML. The Markdown version is available at https://grafana.com/docs/k6/next/javascript-api/k6-ws/socket/socket-ping.md, or by sending Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/k6-ws/socket/socket-ping/. For broader documentation discovery, the curated index is available at https://grafana.com/llms.txt and the complete index is available at https://grafana.com/llms-full.txt.
This is documentation for the next version of Grafana k6 documentation. For the latest stable release, go to the latest version.
Socket.ping()
Note
A module with a better and standard API exists.
The new k6/websockets API partially implements the WebSockets API living standard.
When possible, we recommend using the new API. It uses a global event loop for consistency with other k6 APIs and better performance.
Send a ping. Ping messages can be used to verify that the remote endpoint is responsive.
Example
import ws from 'k6/ws';
export default function () {
const url = 'wss://echo.websocket.org';
const response = ws.connect(url, null, function (socket) {
socket.on('open', function () {
socket.on('pong', function () {
// As required by the spec, when the ping is received, the recipient must send back a pong.
console.log('connection is alive');
});
socket.ping();
});
});
}Was this page helpful?
Related resources from Grafana Labs

