---
title: "WebSocket.close([code]) | Grafana k6 documentation"
description: "Close the WebSocket connection."
---

> For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt).

# WebSocket.close(\[code])

Close the WebSocket connection.

Expand table

| Parameter       | Type   | Description                                                                                                                                         |
|-----------------|--------|-----------------------------------------------------------------------------------------------------------------------------------------------------|
| code (optional) | number | WebSocket status code. (default: 1000) . See [the list of supported](https://developer.mozilla.org/en-US/docs/Web/API/CloseEvent/code) close codes. |

### Example

*A k6 script that initiates a WebSocket connection and closes it using the `onopen` handler.*

JavaScript ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

```javascript
import { WebSocket } from 'k6/websockets';

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

  ws.onopen = () => {
    ws.close();
    console.log('connection closed');
  };
}
```

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

Bash ![Copy code to clipboard](/media/images/icons/icon-copy-small-2.svg) Copy

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