async-mqtt
TypeScript icon, indicating that this package has built-in type declarations

2.6.3 • Public • Published

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();
});

Package Sidebar

Install

npm i async-mqtt

Weekly Downloads

76,134

Version

2.6.3

License

MIT

Unpacked Size

17.1 kB

Total Files

7

Last publish

Collaborators

  • matteo.collina
  • rangermauve
  • tabrizian