• Stars
    star
    267
  • Rank 153,621 (Top 4 %)
  • Language
    JavaScript
  • License
    MIT License
  • Created over 7 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Promise wrapper over MQTT.js

async-mqtt

Promise wrapper over MQTT.js


IMPORTANT: Make sure you handle rejections from returned promises because they won't crash the process

API

The API is the same as MQTT.js, except the following functions now return promises instead of taking callbacks

  • publish
  • subscribe
  • unsubscribe
  • end

Example

const MQTT = require("async-mqtt");

const client = MQTT.connect("tcp://somehost.com:1883");

// When passing async functions as event listeners, make sure to have a try catch block

const doStuff = async () => {

	console.log("Starting");
	try {
		await client.publish("wow/so/cool", "It works!");
		// This line doesn't run until the server responds to the publish
		await client.end();
		// This line doesn't run until the client has disconnected without error
		console.log("Done");
	} catch (e){
		// Do something about it!
		console.log(e.stack);
		process.exit();
	}
}

client.on("connect", doStuff);

Alternately you can skip the event listeners and get a promise.

const MQTT = require("async-mqtt");

run()

async function run() {
  const client = await MQTT.connectAsync("tcp://somehost.com:1883")

  console.log("Starting");
	try {
		await client.publish("wow/so/cool", "It works!");
		// This line doesn't run until the server responds to the publish
		await client.end();
		// This line doesn't run until the client has disconnected without error
		console.log("Done");
	} catch (e){
		// Do something about it!
		console.log(e.stack);
		process.exit();
	}
}

Wrapping existing client

const { AsyncClient } = require("async-mqtt");

const client = getRegularMQTTClientFromSomewhere();

const asyncClient = new AsyncClient(client);

asyncClient.publish("foo/bar", "baz").then(() => {
	console.log("We async now");
	return asyncClient.end();
});