Merge pull request #290282 from MicrosoftDocs/main

Merge main to live, 4 AM

Author: v-ccolin

articles/automation/change-tracking/media/enable-vms-monitoring-agent/select-change-tracking-multiple-vms-expanded.png

@@ -24,7 +24,7 @@
       href: quickstart-java-spring-app.md
     - name: Python
       href: quickstart-python-provider.md
-    - name: JavaScript/Node.js
+    - name: Node.js
       href: quickstart-javascript-provider.md
     - name: Azure Functions
       href: quickstart-azure-functions-csharp.md
@@ -42,8 +42,10 @@
       href: quickstart-feature-flag-spring-boot.md
     - name: Azure Functions
       href: quickstart-feature-flag-azure-functions-csharp.md
-    - name: Python app
+    - name: Python
       href: quickstart-feature-flag-python.md
+    - name: Node.js
+      href: quickstart-feature-flag-javascript.md
     - name: Azure Kubernetes Service
       href: quickstart-feature-flag-azure-kubernetes-service.md
   - name: Service integration
@@ -88,7 +90,7 @@
       href: enable-dynamic-configuration-java-spring-app.md
     - name: Python
       href: enable-dynamic-configuration-python.md
-    - name: JavaScript
+    - name: Node.js
       href: enable-dynamic-configuration-javascript.md
     - name: Azure Kubernetes Service
       href: enable-dynamic-configuration-azure-kubernetes-service.md
@@ -138,6 +140,8 @@
         href: howto-feature-filters.md
       - name: ASP.NET Core
         href: howto-feature-filters-aspnet-core.md
+      - name: JavaScript
+        href: howto-feature-filters-javascript.md
       - name: Python
         href: howto-feature-filters-python.md
     - name: Enable features on a schedule
@@ -146,6 +150,8 @@
         href: howto-timewindow-filter.md
       - name: ASP.NET Core
         href: howto-timewindow-filter-aspnet-core.md
+      - name: JavaScipt
+        href: howto-timewindow-filter-javascript.md
     - name: Roll out features to targeted audience
       items:
       - name: Overview

articles/automation/change-tracking/media/enable-vms-monitoring-agent/select-change-tracking-multiple-vms-inline.png

@@ -0,0 +1,81 @@
+---
+title: Enable conditional features with a custom filter in a Node.js application
+titleSuffix: Azure App Configuration
+description: Learn how to implement a custom feature filter to enable conditional feature flags for your Node.js application.
+ms.service: azure-app-configuration
+ms.devlang: javascript
+author: zhiyuanliang-ms
+ms.author: zhiyuanliang
+ms.topic: how-to
+ms.custom: mode-other, devx-track-js
+ms.date: 09/26/2024
+---
+
+# Tutorial: Enable conditional features with a custom filter in a JavaScript application
+
+Feature flags can use feature filters to enable features conditionally. To learn more about feature filters, see [Tutorial: Enable conditional features with feature filters](./howto-feature-filters.md).
+
+The example used in this tutorial is based on the Node.js application introduced in the feature management [quickstart](./quickstart-feature-flag-javascript.md). Before proceeding further, complete the quickstart to create a Node.js application with a *Beta* feature flag. Once completed, you must [add a custom feature filter](./howto-feature-filters.md) to the *Beta* feature flag in your App Configuration store. 
+
+In this tutorial, you'll learn how to implement a custom feature filter and use the feature filter to enable features conditionally. We are using the Node.js console app as an example, but you can also use the custom feature filter in other JavaScript applications.
+
+## Prerequisites
+
+- Create a [console app with a feature flag](./quickstart-feature-flag-javascript.md).
+- [Add a custom feature filter to the feature flag](./howto-feature-filters.md)
+
+## Implement a custom feature filter
+
+You've added a custom feature filter named **Random** with a **Percentage** parameter for your *Beta* feature flag in the prerequisites. Next, you implement the feature filter to enable the *Beta* feature flag based on the chance defined by the **Percentage** parameter.
+
+1. Open the file *app.js* and add the `RandomFilter` with the following code.
+
+    ``` javascript
+    class RandomFilter {
+        name = "Random";
+        evaluate(context) {
+            const percentage = context.parameters.Percentage;
+            const randomNumber = Math.random() * 100;
+            return randomNumber <= percentage;
+        }
+    }
+    ```
+
+    You added a `RandomFilter` class that has a single method named `evaluate`, which is called whenever a feature flag is evaluated. In `evaluate`, a feature filter enables a feature flag by returning `true`.
+
+    You set the name to of `RandomFilter` to **Random**, which matches the filter name you set in the *Beta* feature flag in Azure App Configuration.
+
+1. Register the `RandomFilter` when creating the `FeatureManager`.
+
+    ``` javascript
+    const fm = new FeatureManager(ffProvider, {customFilters: [new RandomFilter()]});
+    ```
+
+## Feature filter in action
+
+When you run the application the configuration provider will load the *Beta* feature flag from Azure App Configuration. The result of the `isEnabled("Beta")` method will be printed to the console. As the `RandomFilter` is implemented and used by the *Beta* feature flag, the result will be `True` 50 percent of the time and `False` the other 50 percent of the time.
+
+Running the application will show that the *Beta* feature flag is sometimes enabled and sometimes not.
+
+``` bash
+Beta is enabled: true
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: true
+Beta is enabled: true
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: true
+Beta is enabled: true
+```
+
+## Next steps
+
+To learn more about the built-in feature filters, continue to the following tutorials.
+
+> [!div class="nextstepaction"]
+> [Enable features on a schedule](./howto-timewindow-filter.md)
+
+> [!div class="nextstepaction"]
+> [Roll out features to targeted audience](./howto-targetingfilter.md)

articles/automation/change-tracking/media/overview/view-file-changes.png

@@ -55,19 +55,15 @@ You can create custom feature filters that enable features based on your specifi
     > [!div class="mx-imgBorder"]
     > ![Screenshot of the Azure portal, applying new custom filter.](./media/feature-filters/feature-flag-edit-apply-filter.png)
 
-You have successfully added a custom filter to a feature flag. Follow the instructions in the [Next Steps](#next-steps) section to implement the feature filter into your application for the language or platform you are using.
+    You have successfully added a custom filter to a feature flag. 
 
-## Next steps
-
-In this tutorial, you learned the concept of feature filter and added a custom feature filter to a feature flag.
-
-To learn how to implement a custom feature filter, continue to the following tutorial:
+1. Continue to the following instructions to implement the feature filter into your application for the language or platform you are using.
 
-> [!div class="nextstepaction"]
-> [ASP.NET Core](./howto-feature-filters-aspnet-core.md)
+    - [ASP.NET Core](./howto-feature-filters-aspnet-core.md)
+    - [Node.js](./howto-feature-filters-javascript.md)
+    - [Python](./howto-feature-filters-python.md)
 
-> [!div class="nextstepaction"]
-> [Python](./howto-feature-filters-python.md)
+## Next steps
 
 To learn more about the built-in feature filters, continue to the following tutorials:
 

articles/azure-app-configuration/TOC.yml

@@ -68,16 +68,13 @@ In this article, you will learn how to add and configure a targeting filter for
     > [!div class="mx-imgBorder"]
     > ![Screenshot of the Azure portal, applying new targeting filter.](./media/feature-filters/feature-flag-edit-apply-targeting-filter.png)
 
-Now, you successfully added a targeting filter for your feature flag. This targeting filter will use the targeting rule you configured to enable or disable the feature flag for specific users and groups. Follow the instructions in the [Next Steps](#next-steps) section to learn how it works in your application for the language or platform you are using.
+    Now, you successfully added a targeting filter for your feature flag. This targeting filter will use the targeting rule you configured to enable or disable the feature flag for specific users and groups. 
 
-## Next steps
-
-In this tutorial, you learned the concept of the targeting filter and added it to a feature flag.
+1. Continue to the following instructions to use the feature flag with a targeting filter in your application for the language or platform you are using.
 
-To learn how to use the feature flag with a targeting filter in your application, continue to the following tutorial.
+    - [ASP.NET Core](./howto-targetingfilter-aspnet-core.md)
 
-> [!div class="nextstepaction"]
-> [ASP.NET Core](./howto-targetingfilter-aspnet-core.md)
+## Next steps
 
 To learn more about the feature filters, continue to the following tutorials:
 

articles/azure-app-configuration/howto-feature-filters-javascript.md

@@ -0,0 +1,75 @@
+---
+title: Enable features on a schedule in a Node.js application
+titleSuffix: Azure App Configuration
+description: Learn how to enable feature flags on a schedule in a Node.js application.
+ms.service: azure-app-configuration
+ms.devlang: javascript
+author: zhiyuanliang-ms
+ms.author: zhiyuanliang
+ms.topic: how-to
+ms.custom: mode-other, devx-track-js
+ms.date: 09/26/2024
+---
+
+# Tutorial: Enable features on a schedule in a Node.js application
+
+In this tutorial, you use the time window filter to enable a feature on a schedule for a Node.js application. 
+
+The example used in this tutorial is based on the Node.js application introduced in the feature management [quickstart](./quickstart-feature-flag-javascript.md). Before proceeding further, complete the quickstart to create a Node.js application with a *Beta* feature flag. Once completed, you must [add a time window filter](./howto-timewindow-filter.md) to the *Beta* feature flag in your App Configuration store.
+
+## Prerequisites
+
+- Create a [Node.js application with a feature flag](./quickstart-feature-flag-javascript.md).
+- [Add a time window filter to the feature flag](./howto-timewindow-filter.md)
+
+## Use the time window filter
+
+You've added a time window filter for your *Beta* feature flag in the prerequisites. Next, you'll use the feature flag with the time window filter in your Node.js application.
+
+When you create a feature manager, the built-in feature filters are automatically added to its feature filter collection.
+
+``` javascript
+const fm = new FeatureManager(ffProvider);
+```
+
+## Time window filter in action
+
+When you run the application, the configuration provider loads the *Beta* feature flag from Azure App Configuration. The result of the `isEnabled("Beta")` method will be printed to the console. If your current time is earlier than the start time set for the time window filter, the *Beta* feature flag will be disabled by the time window filter.
+
+You'll see the following console outputs.
+
+``` bash
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+```
+
+Once the start time has passed, you'll notice that the *Beta* feature flag is enabled by the time window filter.
+
+You'll see the console outputs change as the *Beta* is enabled.
+
+``` bash
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: false
+Beta is enabled: true
+Beta is enabled: true
+Beta is enabled: true
+Beta is enabled: true
+```
+
+## Next steps
+
+To learn more about the feature filters, continue to the following tutorials.
+
+> [!div class="nextstepaction"]
+> [Enable conditional features with feature filters](./howto-feature-filters.md)
+
+> [!div class="nextstepaction"]
+> [Roll out features to targeted audience](./howto-targetingfilter.md)

articles/azure-app-configuration/howto-feature-filters.md

@@ -39,16 +39,14 @@ In this article, you will learn how to add and configure a time window filter fo
     > [!div class="mx-imgBorder"]
     > ![Screenshot of the Azure portal, applying new time window filter.](./media/feature-filters/feature-flag-edit-apply-timewindow-filter.png)
 
-Now, you successfully added a time window filter to a feature flag. Follow the instructions in the [Next Steps](#next-steps) section to learn how it works in your application for the language or platform you are using.
+    Now, you successfully added a time window filter to a feature flag. 
 
-## Next steps
-
-In this tutorial, you learned the concept of the time window filter and added it to a feature flag.
+1. Continue to the following instructions to use the feature flag with a time window filter in your application for the language or platform you are using.
 
-To learn how to use the feature flag with a time window filter in your application, continue to the following tutorial.
+    - [ASP.NET Core](./howto-timewindow-filter-aspnet-core.md)
+    - [Node.js](./howto-timewindow-filter-javascript.md)
 
-> [!div class="nextstepaction"]
-> [ASP.NET Core](./howto-timewindow-filter-aspnet-core.md)
+## Next steps
 
 To learn more about the feature filters, continue to the following tutorials:
 

articles/azure-app-configuration/howto-targetingfilter.md

@@ -148,6 +148,8 @@ landingContent:
           url: quickstart-feature-flag-spring-boot.md
         - text: Python app
           url: quickstart-feature-flag-python.md
+        - text: Node.js app
+          url: quickstart-feature-flag-javascript.md
       - linkListType: tutorial
         links: 
         - text: Use feature flags in ASP.NET Core