Nine Post Meridiem

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

    Install

    npm i async-mqtt

    DownloadsWeekly Downloads

    33,552

    Version

    2.6.3

    License

    MIT

    Unpacked Size

    17.1 kB

    Total Files

    7

    Last publish

    Collaborators

    • matteo.collina
    • rangermauve
    • tabrizian