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-sendbinary.md, or by sending Accept: text/markdown to https://grafana.com/docs/k6/next/javascript-api/k6-ws/socket/socket-sendbinary/. 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.sendBinary(data)
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 binary data through the connection.
| Parameter | Type | Description |
|---|---|---|
| data | ArrayBuffer | The data to send. |
Example
import ws from 'k6/ws';
const binFile = open('./file.pdf', 'b');
export default function () {
ws.connect('http://wshost/', function (socket) {
socket.on('open', function () {
socket.sendBinary(binFile);
});
socket.on('binaryMessage', function (msg) {
// msg is an ArrayBuffer, so we can wrap it in a typed array directly.
new Uint8Array(msg);
});
});
}- See also Socket.send(data)
Was this page helpful?
Related resources from Grafana Labs

