sync blog

emqx · Sep 20, 2024 · dd9a92b · dd9a92b
1 parent 83291d2
commit dd9a92b
Show file tree

Hide file tree

Showing 5 changed files with 72 additions and 41 deletions.
diff --git a/README.md b/README.md
@@ -8,8 +8,10 @@
 Get to know the preferred protocol in IoT from beginner to master.
 
 - [MQTT Protocol Explained: Ultimate Guide for IoT Beginners](https://www.emqx.com/en/blog/the-easiest-guide-to-getting-started-with-mqtt) ([Edit](https://github.com/emqx/blog/blob/main/en/202408/the-easiest-guide-to-getting-started-with-mqtt.md))
+- [MQTT Topics and Wildcards: A Beginner's Guide](https://www.emqx.com/en/blog/advanced-features-of-mqtt-topics) ([Edit](https://github.com/emqx/blog/blob/main/en/202407/advanced-features-of-mqtt-topics.md))
 - [Connecting MQTT and REST API: A Comprehensive Tutorial](https://www.emqx.com/en/blog/connecting-mqtt-and-rest-api) ([Edit](https://github.com/emqx/blog/blob/main/en/202407/connecting-mqtt-and-rest-api.md))
 - [MQTT vs HTTP: Which is Better Suited for the Internet of Things (IoT)?](https://www.emqx.com/en/blog/mqtt-vs-http) ([Edit](https://github.com/emqx/blog/blob/main/en/202406/mqtt-vs-http.md))
+- [MQTT Retained Messages: Beginner's Guide with Example](https://www.emqx.com/en/blog/mqtt5-features-retain-message) ([Edit](https://github.com/emqx/blog/blob/main/en/202406/mqtt5-features-retain-message.md))
 - [MQTT vs WebSocket: Key Differences & Applications](https://www.emqx.com/en/blog/mqtt-vs-websocket) ([Edit](https://github.com/emqx/blog/blob/main/en/202405/mqtt-vs-websocket.md))
 - [How to Process JSON, Hex, and Binary Data in MQTT](https://www.emqx.com/en/blog/how-to-process-json-hex-and-binary-data-in-mqtt) ([Edit](https://github.com/emqx/blog/blob/main/en/202405/how-to-process-json-hex-and-binary-data-in-mqtt.md))
 - [Mastering MQTT Analysis with Wireshark: A Beginner's Guide](https://www.emqx.com/en/blog/mastering-mqtt-analysis-with-wireshark) ([Edit](https://github.com/emqx/blog/blob/main/en/202405/mastering-mqtt-analysis-with-wireshark.md))
@@ -35,15 +37,13 @@ Get to know the preferred protocol in IoT from beginner to master.
 - [MQTT Maximum Packet Size Explained and Example | MQTT 5 Features](https://www.emqx.com/en/blog/best-practices-of-maximum-packet-size-in-mqtt) ([Edit](https://github.com/emqx/blog/blob/main/en/202307/best-practices-of-maximum-packet-size-in-mqtt.md))
 - [MQTT Subscription Identifier Explained and Example | MQTT 5 Features](https://www.emqx.com/en/blog/subscription-identifier-and-subscription-options) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/subscription-identifier-and-subscription-options.md))
 - [What Is MQTT and Why Is It the Best Protocol for IoT?](https://www.emqx.com/en/blog/what-is-the-mqtt-protocol) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/what-is-the-mqtt-protocol.md))
-- [MQTT Topics and Wildcards: A Beginner's Guide](https://www.emqx.com/en/blog/advanced-features-of-mqtt-topics) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/advanced-features-of-mqtt-topics.md))
 - [MQTT Reason Code Introduction and Quick Reference](https://www.emqx.com/en/blog/mqtt5-new-features-reason-code-and-ack) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/mqtt5-new-features-reason-code-and-ack.md))
 - [MQTT  Subscription Options Explained and Example  | MQTT 5 Features](https://www.emqx.com/en/blog/an-introduction-to-subscription-options-in-mqtt) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/an-introduction-to-subscription-options-in-mqtt.md))
 - [Shaping the Future of IoT: 7 MQTT Technology Trends in 2023](https://www.emqx.com/en/blog/7-mqtt-trends-in-2023) ([Edit](https://github.com/emqx/blog/blob/main/en/202303/7-mqtt-trends-in-2023.md))
 - [Introduction to MQTT Publish-Subscribe Pattern](https://www.emqx.com/en/blog/mqtt-5-introduction-to-publish-subscribe-model) ([Edit](https://github.com/emqx/blog/blob/main/en/202303/mqtt-5-introduction-to-publish-subscribe-model.md))
 - [MQTT QoS 0, 1, 2 Explained: A Quickstart Guide](https://www.emqx.com/en/blog/introduction-to-mqtt-qos) ([Edit](https://github.com/emqx/blog/blob/main/en/202301/introduction-to-mqtt-qos.md))
 - [MQTT Persistent Session and Clean Session Explained](https://www.emqx.com/en/blog/mqtt-session) ([Edit](https://github.com/emqx/blog/blob/main/en/202212/mqtt-session.md))
 - [How to Set Parameters When Establishing an MQTT Connection?](https://www.emqx.com/en/blog/how-to-set-parameters-when-establishing-an-mqtt-connection) ([Edit](https://github.com/emqx/blog/blob/main/en/202211/how-to-set-parameters-when-establishing-an-mqtt-connection.md))
-- [The Beginner's Guide to MQTT Retained Messages](https://www.emqx.com/en/blog/mqtt5-features-retain-message) ([Edit](https://github.com/emqx/blog/blob/main/en/202211/mqtt5-features-retain-message.md))
 - [What is the MQTT Keep Alive parameter for?](https://www.emqx.com/en/blog/mqtt-keep-alive) ([Edit](https://github.com/emqx/blog/blob/main/en/202208/mqtt-keep-alive.md))
 - [MQTT QoS design: Quality assurance for the IoV platform messaging](https://www.emqx.com/en/blog/mqtt-qos-design-for-internet-of-vehicles) ([Edit](https://github.com/emqx/blog/blob/main/en/202204/mqtt-qos-design-for-internet-of-vehicles.md))
 - [MQTT topic design in TSP platform scenario](https://www.emqx.com/en/blog/mqtt-topic-design-for-internet-of-vehicles) ([Edit](https://github.com/emqx/blog/blob/main/en/202204/mqtt-topic-design-for-internet-of-vehicles.md))
@@ -113,7 +113,9 @@ Get to know the preferred protocol in IoT from beginner to master.
 Best practice of MQTT in various clients.
 
 - [A Guide on Collecting and Reporting Soil Moisture with ESP32 and Sensor through MQTT](https://www.emqx.com/en/blog/hands-on-guide-on-esp32) ([Edit](https://github.com/emqx/blog/blob/main/en/202408/hands-on-guide-on-esp32.md))
+- [MQTT on ESP32: A Beginner's Guide](https://www.emqx.com/en/blog/esp32-connects-to-the-free-public-mqtt-broker) ([Edit](https://github.com/emqx/blog/blob/main/en/202408/esp32-connects-to-the-free-public-mqtt-broker.md))
 - [MQTT in Python with Paho Client: Beginner's Guide 2024](https://www.emqx.com/en/blog/how-to-use-mqtt-in-python) ([Edit](https://github.com/emqx/blog/blob/main/en/202408/how-to-use-mqtt-in-python.md))
+- [JavaScript MQTT Client: A Beginner's Guide to MQTT.js](https://www.emqx.com/en/blog/mqtt-js-tutorial) ([Edit](https://github.com/emqx/blog/blob/main/en/202406/mqtt-js-tutorial.md))
 - [Using MQTT on ESP8266: A Quick Start Guide](https://www.emqx.com/en/blog/esp8266-connects-to-the-public-mqtt-broker) ([Edit](https://github.com/emqx/blog/blob/main/en/202405/esp8266-connects-to-the-public-mqtt-broker.md))
 - [How to Use MQTT in the Flutter Project](https://www.emqx.com/en/blog/using-mqtt-in-flutter) ([Edit](https://github.com/emqx/blog/blob/main/en/202405/using-mqtt-in-flutter.md))
 - [How to Use MQTT in Rust with Rumqttc Client](https://www.emqx.com/en/blog/how-to-use-mqtt-in-rust) ([Edit](https://github.com/emqx/blog/blob/main/en/202404/how-to-use-mqtt-in-rust.md))
@@ -128,9 +130,7 @@ Best practice of MQTT in various clients.
 - [Using MQTT in Unity with M2MqttUnity Library: A Step-by-Step Guide](https://www.emqx.com/en/blog/using-mqtt-in-unity-with-m2mqttunity-library-a-step-by-step-guide) ([Edit](https://github.com/emqx/blog/blob/main/en/202308/using-mqtt-in-unity-with-m2mqttunity-library-a-step-by-step-guide.md))
 - [Connecting to Serverless MQTT Broker in PHP](https://www.emqx.com/en/blog/connecting-to-serverless-mqtt-broker-in-php) ([Edit](https://github.com/emqx/blog/blob/main/en/202307/connecting-to-serverless-mqtt-broker-in-php.md))
 - [A Quickstart Guide to Using MQTT over WebSocket](https://www.emqx.com/en/blog/connect-to-mqtt-broker-with-websocket) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/connect-to-mqtt-broker-with-websocket.md))
-- [MQTT on ESP32: A Beginner's Guide](https://www.emqx.com/en/blog/esp32-connects-to-the-free-public-mqtt-broker) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/esp32-connects-to-the-free-public-mqtt-broker.md))
 - [How to Use MQTT on Raspberry Pi with Paho Python Client](https://www.emqx.com/en/blog/use-mqtt-with-raspberry-pi) ([Edit](https://github.com/emqx/blog/blob/main/en/202306/use-mqtt-with-raspberry-pi.md))
-- [JavaScript MQTT Client: A Beginner's Guide to MQTT.js](https://www.emqx.com/en/blog/mqtt-js-tutorial) ([Edit](https://github.com/emqx/blog/blob/main/en/202305/mqtt-js-tutorial.md))
 - [MQTT with Node.js: A Beginner's Guide with Examples & FAQs](https://www.emqx.com/en/blog/how-to-use-mqtt-in-nodejs) ([Edit](https://github.com/emqx/blog/blob/main/en/202305/how-to-use-mqtt-in-nodejs.md))
 - [How to Use MQTT in Dart](https://www.emqx.com/en/blog/how-to-use-mqtt-in-dart) ([Edit](https://github.com/emqx/blog/blob/main/en/202211/how-to-use-mqtt-in-dart.md))
 - [How to Use MQTT in The Django Project](https://www.emqx.com/en/blog/how-to-use-mqtt-in-django) ([Edit](https://github.com/emqx/blog/blob/main/en/202210/how-to-use-mqtt-in-django.md))

diff --git a/en/202305/mqtt-js-tutorial.md → en/202406/mqtt-js-tutorial.md b/en/202305/mqtt-js-tutorial.md → en/202406/mqtt-js-tutorial.md
@@ -1,15 +1,28 @@
 ## Introduction
 
-[MQTT.js](https://github.com/mqttjs/MQTT.js) is a client library for the [MQTT protocol](https://www.emqx.com/en/blog/the-easiest-guide-to-getting-started-with-mqtt), written in JavaScript for both Node.js and the browser. It is currently the most widely used [MQTT client library](https://www.emqx.com/en/mqtt-client-sdk) in the JavaScript ecosystem.
+In the rapidly evolving world of Internet of Things (IoT) and real-time communication, MQTT (Message Queuing Telemetry Transport) has emerged as a crucial protocol. For JavaScript developers looking to harness the power of MQTT in their applications, [**MQTT.js**](https://github.com/mqttjs/MQTT.js) stands out as an essential tool.
 
-> MQTT is a lightweight IoT messaging protocol based on the publish/subscribe model. It can provide real-time and reliable messaging services for networked devices with very little code and bandwidth. It is widely used in industries such as IoT, mobile Internet, smart hardware, Internet of Vehicles, and power energy.
+**MQTT.js** is a robust client library for the [**MQTT protocol**](https://www.emqx.com/en/blog/the-easiest-guide-to-getting-started-with-mqtt), meticulously crafted in JavaScript to cater to both Node.js and browser environments. Its versatility and efficiency have made it the most widely adopted [**MQTT client library**](https://www.emqx.com/en/mqtt-client-sdk) within the JavaScript ecosystem, empowering developers to create sophisticated IoT and messaging applications with ease.
 
-Due to the single-thread feature of JavaScript, MQTT.js is a fully asynchronous MQTT client. It supports MQTT/TCP, MQTT/TLS, and MQTT/WebSocket. The degree of support in different operating environments is as follows:
+Key features of MQTT.js include:
 
-- Browser: [MQTT over WebSocket](https://www.emqx.com/en/blog/connect-to-mqtt-broker-with-websocket)
-- Node.js: MQTT and MQTT over WebSocket
+- Asynchronous Operation: Leveraging JavaScript's single-threaded nature, MQTT.js operates as a fully asynchronous MQTT client, ensuring optimal performance and responsiveness in your applications.
 
-> Note: Other APIs are the same in different environments except for a few different connection parameters. For MQTT.js v3.0.0 and later versions, MQTT 5.0 is fully supported.
+- Broad Protocol Support: The library seamlessly supports MQTT/TCP, MQTT/TLS, and MQTT/WebSocket, providing flexibility for various network configurations and security requirements.
+
+- Cross-Platform Compatibility: MQTT.js offers tailored support for different operating environments:
+
+  - Browser: Enables [**MQTT over WebSocket**](https://www.emqx.com/en/blog/connect-to-mqtt-broker-with-websocket), allowing real-time communication in web applications.
+
+  - Node.js: Supports both MQTT and MQTT over WebSocket, catering to server-side applications and IoT devices.
+
+This guide aims to introduce beginners to the world of MQTT.js, exploring its setup, basic usage, and practical applications. We'll cover topics such as:
+
+- Setting up MQTT.js in your project
+- Connecting to an MQTT broker
+- Publishing and subscribing to topics
+- Handling messages and events
+- Best practices for error handling and security
 
 ## Installation
 
@@ -63,9 +76,7 @@ Before proceeding, ensure that you have an [MQTT broker](https://www.emqx.com/en
 
 - **Fully managed cloud service**
 
-  The fully managed cloud service is the easiest way to start an MQTT service. With [EMQX Cloud](https://www.emqx.com/en/cloud), you can get started in just a few minutes and run your MQTT service in 20+ regions across AWS, Google Cloud, and Microsoft Azure, ensuring global availability and fast connectivity.
-
-  The latest edition, [EMQX Cloud Serverless](https://www.emqx.com/en/cloud/serverless-mqtt), provides a complimentary offering of 1M session minutes/month for developers to easily start their MQTT deployment within seconds.
+  The fully managed cloud service is the easiest way to start an MQTT service. With [EMQX Serverless](https://www.emqx.com/en/cloud/serverless-mqtt), you can get started in just a few minutes and run your MQTT service in 20+ regions across AWS, Google Cloud, and Microsoft Azure, ensuring global availability and fast connectivity. It provides a complimentary offering of 1M session minutes/month for developers to easily start their MQTT deployment within seconds.
 
 - **Free public MQTT broker**
 
@@ -108,6 +119,7 @@ For more information, please check out: [Free Public MQTT Broker](https://www.em
   </div>
 </section>
 
+
 ## Simple MQTT.js Example
 
 We will provide an example of how to connect to EMQX Cloud, subscribe to topics, and send and receive messages using MQTT.js.
@@ -510,7 +522,7 @@ nonSYSMessage$.pipe(bufferTime(500)).subscribe((messages: MessageModel[]) => {
 
 ## Summary
 
-This article has briefly introduced the usage functions of some common APIs of MQTT.js. To learn about MQTT topics, wildcards, retained messages, last-will, and other features, check out the [MQTT Guide 2023: Beginner to Advanced](https://www.emqx.com/en/mqtt-guide) series of articles provided by EMQ. Explore more advanced applications of MQTT and get started with MQTT application and service development.
+This article has briefly introduced the usage functions of some common APIs of MQTT.js. To learn about [MQTT topics](https://www.emqx.com/en/blog/advanced-features-of-mqtt-topics), wildcards, retained messages, last-will, and other features, check out the [MQTT Guide 2024: Beginner to Advanced](https://www.emqx.com/en/mqtt-guide) series of articles provided by EMQ. Explore more advanced applications of MQTT and get started with MQTT application and service development.
 
 For specific use in actual projects, please refer to the following links.
 
@@ -520,13 +532,14 @@ For specific use in actual projects, please refer to the following links.
 - [How to Use MQTT in Electron](https://www.emqx.com/en/blog/how-to-use-mqtt-in-electron)
 - [How to Use MQTT in Node.js](https://www.emqx.com/en/blog/how-to-use-mqtt-in-nodejs)
 - [A Quickstart Guide to Using MQTT over WebSocket](https://www.emqx.com/en/blog/connect-to-mqtt-broker-with-websocket)
+- [MQTT vs WebSocket: Key Differences & Applications](https://www.emqx.com/en/blog/mqtt-vs-websocket)
 
 
 
 <section class="promotion">
     <div>
-        Try EMQX Cloud for Free
-        <div class="is-size-14 is-text-normal has-text-weight-normal">A fully managed MQTT service for IoT</div>
+        Try EMQX Serverless for Free
+        <div class="is-size-14 is-text-normal has-text-weight-normal">Forever free under 1M session minutes/month</div>
     </div>
     <a href="https://accounts.emqx.com/signup?continue=https://cloud-intl.emqx.com/console/deployments/0?oper=new" class="button is-gradient px-5">Get Started →</a>
 </section>