> For the complete documentation index, see [llms.txt](https://brianbuccaneer.gitbook.io/rxws/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://brianbuccaneer.gitbook.io/rxws/dev-1/api/operators/messages.md).

# messages

## Description

Listen for all message events from the WebSocket client.

## Usage

**Basic Usage**:

```javascript
import { messages, ws } from '@buccaneer/rxws';

const ws$ = ws({url: 'wss://mysite.com'});
const messages$ = ws$.pipe(
  messages()
);

messages$.subscribe(console.log);
// Output
// {topic: 'message', message: 'first message'}
// {topic: 'message', message: 'second message'}
```

**With a topic**:

```javascript
import { messages, ws } from '@buccaneer/rxws';

const ws$ = ws({url: 'wss://mysite.com', topics: ['news']});
const messages$ = ws$.pipe(
  messages('news')
);

messages$.subscribe(console.log);
// Output
// {topic: 'news', message: 'first message'}
// {topic: 'news', message: 'second message'}
```

## API

```
messages(topic = 'message')
```

### Since

1.0

### Parameters

None

### Options

`topic<String>`: specific topics to subscribe to. Defaults to `'message'`.

### Returns

`{topic<String>,message<Any>}`