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

Versions

Current Tags

  • Version
    Downloads (Last 7 Days)
    • Tag
  • 2.6.3
    73,297
    • latest

Version History

Package Sidebar

Install

npm i async-mqtt

Weekly Downloads

77,450

Version

2.6.3

License

MIT

Unpacked Size

17.1 kB

Total Files

7

Last publish

Collaborators

  • matteo.collina
  • rangermauve
  • tabrizian