Merge pull request #301255 from TimShererWithAquent/us439212-03

Stacyrch140 · web-flow · commit 7c49830dbd45 · 2025-06-13T11:21:44.000-04:00
Freshness Edit: Azure Messaging Service (3 of 10)
diff --git a/articles/service-bus-messaging/service-bus-nodejs-how-to-use-queues.md b/articles/service-bus-messaging/service-bus-nodejs-how-to-use-queues.md
@@ -1,53 +1,57 @@
 ---
-title: Get started with Azure Service Bus queues (JavaScript)
+title: 'Quickstart: Get started with Azure Service Bus queues (JavaScript)'
 description: This tutorial shows you how to send messages to and receive messages from Azure Service Bus queues using the JavaScript programming language.
 author: spelluru
 ms.author: spelluru
-ms.date: 12/08/2023
+ms.date: 06/13/2025
 ms.topic: quickstart
 ms.devlang: javascript
 ms.custom: devx-track-js, mode-api
+#customer intent: As a developer, I want to learn how to send and receive messages with Azure Service Bus queues by using the Python programming language.
 ---
 
-# Send messages to and receive messages from Azure Service Bus queues (JavaScript)
+# Quickstart: Send messages to and receive messages from Azure Service Bus queues (JavaScript)
 > [!div class="op_single_selector" title1="Select the programming language:"]
-> * [C#](service-bus-dotnet-get-started-with-queues.md)
-> * [Java](service-bus-java-how-to-use-queues.md)
-> * [JavaScript](service-bus-nodejs-how-to-use-queues.md)
-> * [Python](service-bus-python-how-to-use-queues.md)
+> - [C#](service-bus-dotnet-get-started-with-queues.md)
+> - [Java](service-bus-java-how-to-use-queues.md)
+> - [JavaScript](service-bus-nodejs-how-to-use-queues.md)
+> - [Python](service-bus-python-how-to-use-queues.md)
 
-In this tutorial, you complete the following steps:
+This quickstart provides step-by-step instructions for a simple scenario of sending messages to a Service Bus queue and receiving them. In this quickstart, you complete the following tasks:
 
-1. Create a Service Bus namespace, using the Azure portal.
-2. Create a Service Bus queue, using the Azure portal.
-3. Write a JavaScript application to use the [@azure/service-bus](https://www.npmjs.com/package/@azure/service-bus) package to:
-    1. Send a set of messages to the queue.
-    1. Receive those messages from the queue.
+- Create a Service Bus namespace, using the Azure portal.
+- Create a Service Bus queue, using the Azure portal.
+- Write a JavaScript application to use the [@azure/service-bus](https://www.npmjs.com/package/@azure/service-bus) package to:
+ 
+  - Send a set of messages to the queue.
+  - Receive those messages from the queue.
 
-> [!NOTE]
-> This quick start provides step-by-step instructions for a simple scenario of sending messages to a Service Bus queue and receiving them. You can find pre-built JavaScript and TypeScript samples for Azure Service Bus in the [Azure SDK for JavaScript repository on GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/servicebus/service-bus/samples/v7).
+You can find prebuilt JavaScript and TypeScript samples for Azure Service Bus in the [Azure SDK for JavaScript repository on GitHub](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/servicebus/service-bus/samples/v7).
+
+If you're new to the service, see [Service Bus overview](service-bus-messaging-overview.md) before you begin.
 
 ## Prerequisites
 
-If you're new to the service, see [Service Bus overview](service-bus-messaging-overview.md) before you do this quickstart.
+- An Azure subscription. To complete this quickstart, you need an Azure account. You can activate your [Monthly Azure credits for Visual Studio subscribers](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/?WT.mc_id=A85619ABF) or sign-up for a [free account](https://azure.microsoft.com/free/?WT.mc_id=A85619ABF).
 
-- An Azure subscription. To complete this tutorial, you need an Azure account. You can activate your [MSDN subscriber benefits](https://azure.microsoft.com/pricing/member-offers/credit-for-visual-studio-subscribers/?WT.mc_id=A85619ABF) or sign-up for a [free account](https://azure.microsoft.com/free/?WT.mc_id=A85619ABF).
 - [Node.js LTS](https://nodejs.org/en/download/package-manager/)
 
 ### [Passwordless](#tab/passwordless)
 
-To use this quickstart with your own Azure account, you need:
-* Install [Azure CLI](/cli/azure/install-azure-cli), which provides the passwordless authentication to your developer machine.
-* Sign in with your Azure account at the terminal or command prompt with `az login`.
-* Use the same account when you add the appropriate data role to your resource.
-* Run the code in the same terminal or command prompt.
-* Note down your **queue** name for your Service Bus namespace. You'll need that in the code.
+To use this quickstart with your own Azure account:
+
+- Install [Azure CLI](/cli/azure/install-azure-cli), which provides the passwordless authentication to your developer machine.
+- Sign in with your Azure account at a command prompt with `az login`.
+- Use the same account when you add the appropriate data role to your resource.
+- Run the code in the same Command Prompt window.
+- Make a note of your **queue** name for your Service Bus namespace. You need that in the code.
 
 ### [Connection string](#tab/connection-string)
 
-Note down the following, which you'll use in the code below:
-* Service Bus namespace **connection string**
-* Service Bus namespace **queue** you created
+Make a note of the following values to use in the code:
+
+- Service Bus namespace **connection string**
+- Service Bus namespace **queue** you created
 
 ---
 
@@ -65,23 +69,23 @@ Note down the following, which you'll use in the code below:
 
 ### [Passwordless](#tab/passwordless)
 
-1. To install the required npm package(s) for Service Bus, open a command prompt that has `npm` in its path, change the directory to the folder where you want to have your samples and then run this command.
+1. To install the required npm packages for Service Bus, open a Command Prompt window that has `npm` in its path and change the directory to the folder where you want to have your samples.
 
 1. Install the following packages:
 
-    ```bash
-    npm install @azure/service-bus @azure/identity
-    ```
+   ```bash
+   npm install @azure/service-bus @azure/identity
+   ```
 
 ### [Connection string](#tab/connection-string)
 
-1. To install the required npm package(s) for Service Bus, open a command prompt that has `npm` in its path, change the directory to the folder where you want to have your samples and then run this command.
+1. To install the required npm packages for Service Bus, open a Command Prompt window that has `npm` in its path and change the directory to the folder where you want to have your samples.
 
 1. Install the following package:
 
-    ```bash
-    npm install @azure/service-bus
-    ```
+   ```bash
+   npm install @azure/service-bus
+   ```
 
 ---
 
@@ -91,13 +95,13 @@ The following sample code shows you how to send a message to a queue.
 
 ### [Passwordless](#tab/passwordless)
 
-You must have signed in with the Azure CLI's `az login` in order for your local machine to provide the passwordless authentication required in this code.
+Sign in with the Azure CLI command `az login` for your local machine to provide the passwordless authentication required in this code.
 
-1. Open your favorite editor, such as [Visual Studio Code](https://code.visualstudio.com/).
-1. Create a file called `send.js` and paste the below code into it. This code sends the names of scientists as messages to your queue.
+1. Open a text editor, such as [Visual Studio Code](https://code.visualstudio.com/).
+1. Create a file called `send.js` and paste the following code into it. This code sends the names of scientists as messages to your queue.
 
     > [!IMPORTANT]
-    > The passwordless credential is provided with the [**DefaultAzureCredential**](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#defaultazurecredential).
+    > The passwordless credential is provided by using the [**DefaultAzureCredential**](https://github.com/Azure/azure-sdk-for-js/tree/main/sdk/identity/identity#defaultazurecredential).
 
     ```javascript
     const { ServiceBusClient } = require("@azure/service-bus");
@@ -178,23 +182,24 @@ You must have signed in with the Azure CLI's `az login` in order for your local
         });
     ```
 
-3. Replace `<SERVICE-BUS-NAMESPACE>` with your Service Bus namespace.
-4. Replace `<QUEUE NAME>` with the name of the queue.
-5. Then run the command in a command prompt to execute this file.
+1. Replace `<SERVICE-BUS-NAMESPACE>` with your Service Bus namespace.
+1. Replace `<QUEUE NAME>` with the name of the queue.
+1. To run the code in this file, use this command at a command prompt:
 
-    ```console
-    node send.js
-    ```
-6. You should see the following output.
+   ```console
+   node send.js
+   ```
 
-    ```console
-    Sent a batch of messages to the queue: myqueue
-    ```
+   You should see the following output.
+
+   ```console
+   Sent a batch of messages to the queue: myqueue
+   ```
 
 ### [Connection string](#tab/connection-string)
 
-1. Open your favorite editor, such as [Visual Studio Code](https://code.visualstudio.com/).
-1. Create a file called `send.js` and paste the below code into it. This code sends the names of scientists as messages to your queue.
+1. Open a text editor, such as [Visual Studio Code](https://code.visualstudio.com/).
+1. Create a file called `send.js` and paste the following code into it. This code sends the names of scientists as messages to your queue.
 
     ```javascript
     const { ServiceBusClient } = require("@azure/service-bus");
@@ -270,29 +275,29 @@ You must have signed in with the Azure CLI's `az login` in order for your local
         process.exit(1);
      });
     ```
-3. Replace `<CONNECTION STRING TO SERVICE BUS NAMESPACE>` with the connection string to your Service Bus namespace.
-4. Replace `<QUEUE NAME>` with the name of the queue.
-5. Then run the command in a command prompt to execute this file.
+1. Replace `<CONNECTION STRING TO SERVICE BUS NAMESPACE>` with the connection string to your Service Bus namespace.
+1. Replace `<QUEUE NAME>` with the name of the queue.
+1. To run the code in this file, use this command at a command prompt:
 
-    ```console
-    node send.js
-    ```
-6. You should see the following output.
+   ```console
+   node send.js
+   ```
+   You should see the following output.
 
-    ```console
-    Sent a batch of messages to the queue: myqueue
-    ```
+   ```console
+   Sent a batch of messages to the queue: myqueue
+   ```
 
 ---
 
 ## Receive messages from a queue
 
 ### [Passwordless](#tab/passwordless)
 
-You must have signed in with the Azure CLI's `az login` in order for your local machine to provide the passwordless authentication required in this code.
+Sign in with the Azure CLI command `az login` for your local machine to provide the passwordless authentication required in this code.
 
-1. Open your favorite editor, such as [Visual Studio Code](https://code.visualstudio.com/)
-2. Create a file called `receive.js` and paste the following code into it.
+1. Open a text editor, such as [Visual Studio Code](https://code.visualstudio.com/).
+1. Create a file called `receive.js` and paste the following code into it.
 
     ```javascript
     const { delay, ServiceBusClient, ServiceBusMessage } = require("@azure/service-bus");
@@ -342,18 +347,19 @@ You must have signed in with the Azure CLI's `az login` in order for your local
         process.exit(1);
      });
     ```
-3. Replace `<SERVICE-BUS-NAMESPACE>` with your Service Bus namespace.
-4. Replace `<QUEUE NAME>` with the name of the queue.
-5. Then run the command in a command prompt to execute this file.
 
-    ```console
-    node receive.js
-    ```
+1. Replace `<SERVICE-BUS-NAMESPACE>` with your Service Bus namespace.
+1. Replace `<QUEUE NAME>` with the name of the queue.
+1. To run the code in this file, use this command at a command prompt:
+
+   ```console
+   node receive.js
+   ```
 
 ### [Connection string](#tab/connection-string)
 
-1. Open your favorite editor, such as [Visual Studio Code](https://code.visualstudio.com/)
-2. Create a file called `receive.js` and paste the following code into it.
+1. Open your favorite editor, such as [Visual Studio Code](https://code.visualstudio.com/).
+1. Create a file called `receive.js` and paste the following code into it.
 
     ```javascript
     const { delay, ServiceBusClient, ServiceBusMessage } = require("@azure/service-bus");
@@ -400,14 +406,13 @@ You must have signed in with the Azure CLI's `az login` in order for your local
      });
     ```
 
-3. Replace `<CONNECTION STRING TO SERVICE BUS NAMESPACE>` with the connection string to your Service Bus namespace.
-
-4. Replace `<QUEUE NAME>` with the name of the queue.
-5. Then run the command in a command prompt to execute this file.
+1. Replace `<CONNECTION STRING TO SERVICE BUS NAMESPACE>` with the connection string to your Service Bus namespace.
+1. Replace `<QUEUE NAME>` with the name of the queue.
+1. To run the code in this file, use this command at a command prompt:
 
-    ```console
-    node receive.js
-    ```
+   ```console
+   node receive.js
+   ```
 
 ---
 
@@ -426,26 +431,27 @@ Received message: Johannes Kepler
 Received message: Nikolaus Kopernikus
 ```
 
-On the **Overview** page for the Service Bus namespace in the Azure portal, you can see **incoming** and **outgoing** message count. You may need to wait for a minute or so and then refresh the page to see the latest values.
+On the **Overview** page for the Service Bus namespace in the Azure portal, you can see **incoming** and **outgoing** message count. You might need to wait for a minute or so and then refresh the page to see the latest values.
 
-:::image type="content" source="./media/service-bus-java-how-to-use-queues/overview-incoming-outgoing-messages.png" alt-text="Incoming and outgoing message count":::
+:::image type="content" source="./media/service-bus-java-how-to-use-queues/overview-incoming-outgoing-messages.png" alt-text="Screenshot shows iIncoming and outgoing message count." lightbox="./media/service-bus-java-how-to-use-queues/overview-incoming-outgoing-messages.png":::
 
 Select the queue on this **Overview** page to navigate to the **Service Bus Queue** page. You see the **incoming** and **outgoing** message count on this page too. You also see other information such as the **current size** of the queue, **maximum size**, **active message count**, and so on.
 
-:::image type="content" source="./media/service-bus-java-how-to-use-queues/queue-details.png" alt-text="Queue details":::
+:::image type="content" source="./media/service-bus-java-how-to-use-queues/queue-details.png" alt-text="Screenshot shows Queue detail information." lightbox="./media/service-bus-java-how-to-use-queues/queue-details.png":::
 
 ## Troubleshooting
 
-If you receive one of the following errors when running the **passwordless** version of the JavaScript code, make sure you are signed in via the Azure CLI command, `az login` and the [appropriate role](#azure-built-in-roles-for-azure-service-bus) is applied to your Azure user account:
+If you receive one of the following errors when you run the **passwordless** version of the JavaScript code, sign in by using the Azure CLI command, `az login`. The [appropriate role](service-bus-nodejs-how-to-use-queues.md?tabs=passwordless#azure-built-in-roles-for-azure-service-bus) is applied to your Azure user account:
 
-* 'Send' claim(s) are required to perform this operation
-* 'Receive' claim(s) are required to perform this operation
+- 'Send' claims are required to perform this operation
+- 'Receive' claims are required to perform this operation
 
 ## Clean up resources
 
 Navigate to your Service Bus namespace in the Azure portal, and select **Delete** on the Azure portal to delete the namespace and the queue in it.
 
-## Next steps
+## Related content
+
 See the following documentation and samples:
 
 - [Azure Service Bus client library for JavaScript](https://www.npmjs.com/package/@azure/service-bus)
