hivemq / hivemq-mqtt-web-client

A websockets based MQTT Client for your browser.

hivemq-mqtt-web-client

A websockets based MQTT Client for your browser.

This client runs on any modern browser, which supports websockets (sorry Internet Explorer <10!). You can use it to publish and subscribe at the same time.

See it in action at http://hivemq.com/demos/websocket-client/

How to use it

Read the blog post about "A full-featured MQTT client for your browser"

Localhost / Local network

You can also use this client to connect to a broker on your local machine ("localhost") or any machine in your local network which is reachable from the machine which your browser runs on.

MQTT Broker

This web client works perfectly with the HiveMQ MQTT broker with enabled websockets.

If you don’t like to use a self hosted (or locally running) HiveMQ, you can use the public MQTT broker from the MQTTDashboard.

• Host: broker.mqttdashboard.com
• Websockets port: 8000

Why another MQTT Client

We at HiveMQ needed a quick and simple way to develop and test our applications which use MQTT over websockets, so we sat down for a few hours and built this client which also works for your local development machine.

Can I embedd it / ship it with my software?

Sure! We would however be very glad if you would honor the work by linking to the original client source or mentioning that this websocket client was developed initially for HiveMQs websocket support.

Contributing

If you want to contribute to HiveMQ MQTT Web Client, see the contribution guidelines.

License

HiveMQ MQTT Web Client is licensed under the APACHE LICENSE, VERSION 2.0. A copy of the license can be found here.

hivemq-mqtt-web-client's Issues

Publishing a msg results in a disconnect

I'm having a weird issue with hivemq + webclient where publising a message to the topic below simply disconnects the webclient.

• m2mbox/DavyFarm/schedule

Also using the mosquitto_pub / mosquitto_sub cmdline I'm unable to see msgs published to that topic.

Publishing messages to m2mbox/DavyFarm/schedule2 does work, so it is related to a specific set of topics.

It's as if this topic has been blacklisted or is having some kind of issue.

Would it be possible to look into this ?

Websocket client incorrectly assumes websocket frames and mqtt frames are aligned

The specs say:

MQTT-6.0.0-2: A single WebSocket data frame can contain multiple or partial MQTT Control Packets. The receiver MUST NOT assume that MQTT Control Packets are aligned on WebSocket frame boundaries.

The HiveMQ websocket client does assume that. You can see that a message is split up here looking at raw WS frames:

The '06 ' is just an ASCII print of the MQTT raw data. The string heartbeat is the topic, and Heartbeat at... the payload.

The server closes the connection:

The websocket frames show that the data continues with " CEST 2021". So, the first char is a space, in other words: 0b00100000. In MQTT, the first bytes of a CONNACK is also 0b00100000, followed by the response code. So, hence the error code 'bad connack', because it thinks it's a MQTT connack packet, because it assumes websocket frame == mqtt frame.

The client needs to do its own frame bookkeeping, and not rely on the browser only delivering complete frames.

Why is the path hardcoded /mqtt ?

I am relatively new to MQTT, but as far as I know, there is no need to have the feed path starting with /mqtt. I found the code here:
https://github.com/hivemq/hivemq-mqtt-web-client/blob/master/js/mqttws31.js#L912

That causes on my side:

Is there a reason why this is hardcoded, otherwise I will create a pull request.

Doesn't work with HTTPS

My Webserver supports TLS/SSL but if i click on "CONNECT" the App doesn''t react

How can add TLS/SSL Support ?

Same happens on http://www.hivemq.com/demos/websocket-client/

Thank you

http://www.hivemq.com/demos/websocket-client/ dont work?

Hi,
the websocket client demo sample seem dont work, is it can work,or it have stop work and support.

http://www.hivemq.com/demos/websocket-client/

When a new message is posted, the retain indication is not shown in the table

Steps to reproduce

• Add a subscriber to testtopic/#
• Use the UI (or mosquitto_pub) to send a message with the retained flag set to true
• Notice how the message added to the list is not marked retained
• Remove subscriber from testtopic/#
• Add a subscriber to testtopic/#
• Notice how the message added in step 3 is now marked retained

Seems like the onMessageArrived callback always returns messages with the retain set to false.

Upgrade to MQTT 3.1.1

Hi!

The websocket-client uses the 3.1. version from mqttws31.js. There is exists a newer version where the clientId length extended to 65535.

https://eclipse.org/paho/clients/js/

PUBREL has a wrong format

When the client send PUBREL packet to server (QoS=2) it send wrong fixed header = 0x60,
but according MQTT protocol 3.1 and 3.1.1 fixed header for this packet has to be = 0x62.

all settings lost after reboot

Hi. Running hivemq web client locally in a raspberry. all seems good, but after a reboot all settings are lost.
is there a way to make them persisent, please?

settings host & port from config.js no longer working

Seems in commit #21 the reference to config.js has been removed. Now the configured host and port are no longer working

4c424fe#diff-0eb547304658805aad788d320f10bf1f292797b5e6d745a3bf617584da017051L305

Add new Topic Subscription does not work

i have used the files for my own web site to test the functionality. Publishing topics works as expected, however Subscribing cannot be tested because when pressing the button "Add New Topic Subscription", no window opens like the one on the demo in the HiveMQ website.