added Nunit docs

vvs11 · vvs11 · commit 7ebea0a674c4 · 2024-11-07T02:43:39.000+05:30
diff --git a/articles/playwright-testing/how-to-manage-authentication.md b/articles/playwright-testing/how-to-manage-authentication.md
@@ -4,6 +4,8 @@ description: Learn how to manage authentication and authorization for Microsoft
 ms.topic: how-to
 ms.date: 09/07/2024
 ms.custom: playwright-testing-preview
+zone_pivot_group_filename: playwright-testing/ZonePivotGroups.json
+zone_pivot_groups: microsoft-playwright-testing
 ---
 
 # Manage authentication and authorization for Microsoft Playwright Testing preview
@@ -48,6 +50,7 @@ To enable authentication using access tokens:
 > Authentication using access tokens is less secure. [Learn how to manage access tokens](./how-to-manage-access-tokens.md)
 
 ## Set up authentication using access-tokens
+::: zone pivot="playwright-test-runner"
 
 1. While running the tests, enable access token auth in the `playwright.service.config.ts` file in your setup. 
 
@@ -57,15 +60,28 @@ To enable authentication using access tokens:
         serviceAuthType:'ACCESS_TOKEN'
     }));
     ```
+::: zone-end
+
+::: zone pivot="nunit-test-runner"
+1. While running the tests, enable access token auth in the `.runsettings` file in your setup. 
+
+    ```xml
+    <TestRunParameters>
+        <!-- Use this option when you want to authenticate using access tokens. This mode of auth should be enabled for the workspace. -->
+         <Parameter name="ServiceAuthType" value="EntraId" />
+    </TestRunParameters>
+    ```
+::: zone-end
 
 1. Create access token 
 
     Follow the steps to [create an access token](./how-to-manage-access-tokens.md#generate-a-workspace-access-token)
 
+
 1. Set up your environment
 
     To set up your environment, you have to configure the `PLAYWRIGHT_SERVICE_ACCESS_TOKEN` environment variable with the value you obtained in the previous steps.
-
+::: zone pivot="playwright-test-runner"
     We recommend that you use the `dotenv` module to manage your environment. With `dotenv`, you define your environment variables in the `.env` file.
 
     1. Add the `dotenv` module to your project:
@@ -82,15 +98,26 @@ To enable authentication using access tokens:
 
         Make sure to replace the `{MY-ACCESS-TOKEN}` text placeholder with the value you copied earlier.
 
+::: zone-end
 
+::: zone pivot="nunit-test-runner"
+    Make sure this environment variable is available in your setup where you are running tests. 
+::: zone-end
 ## Run tests on the service and publish results
 
 Run Playwright tests against cloud-hosted browsers and publish the results to the service using the configuration you created above.
 
+::: zone pivot="playwright-test-runner"
 ```typescript
 npx playwright test --config=playwright.service.config.ts --workers=20
 ```
+::: zone-end
 
+::: zone pivot="nunit-test-runner"
+```bash
+dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20
+```
+::: zone-end
 ## Related content
 
 - Learn more about [managing access tokens](./how-to-manage-access-tokens.md).
diff --git a/articles/playwright-testing/how-to-use-service-features.md b/articles/playwright-testing/how-to-use-service-features.md
@@ -4,6 +4,8 @@ description: Learn how to use different features offered by Microsoft Playwright
 ms.topic: how-to
 ms.date: 09/07/2024
 ms.custom: playwright-testing-preview
+zone_pivot_group_filename: playwright-testing/ZonePivotGroups.json
+zone_pivot_groups: microsoft-playwright-testing
 ---
 
 # Use features of Microsoft Playwright Testing preview
@@ -48,7 +50,7 @@ You can also choose to use either feature or both for a test run.
 
 > [!IMPORTANT]
 > You can only use a feature in a test run if it is enabled for the workspace.
-
+::: zone pivot="playwright-test-runner"
 1. In your Playwright setup, go to `playwright.service.config.ts` file and use these settings for feature management. 
 
 ```typescript
@@ -87,7 +89,51 @@ export default defineConfig(
       ["@azure/microsoft-playwright-testing/reporter"]],
       ```
 
+::: zone-end
+
+::: zone pivot="nunit-test-runner"
+
+1. In your Playwright setup, go to `.runsettings` file and use these settings for feature management. 
+
+```xml
+﻿<?xml version="1.0" encoding="utf-8"?>
+<RunSettings>
+    <TestRunParameters>
+        <!--Select if you want to use cloud-hosted browsers to run your Playwright tests.-->
+        <Parameter name="UseCloudHostedBrowsers" value="true" />
+    </TestRunParameters>
+  <!-- NUnit adapter -->  
+  .
+  .
+  .
+    <LoggerRunSettings>
+        <Loggers>
+            <!--microsoft playwright testing service logger for reporting -->
+            <Logger friendlyName="microsoft-playwright-testing" enabled="True" />
+            <!--could enable any logger additionally -->
+            <Logger friendlyName="trx" enabled="false" />
+        </Loggers>
+    </LoggerRunSettings>
+</RunSettings>
+
+```
 
+* **`useCloudHostedBrowsers`**
+    - **Description**: This setting allows you to choose whether to use cloud-hosted browsers or the browsers on your client machine to run your Playwright tests. If you disable this option, your tests run on the browsers of your client machine instead of cloud-hosted browsers, and you don't incur any charges.
+    - **Default Value**: true
+    - **Example**:
+      ```xml
+      <Parameter name="UseCloudHostedBrowsers" value="true" />
+      ```   
+
+* **`reporter`**
+    - **Description**: You can publish your test results and artifacts to the service using `microsoft-playwright-testing` logger. You can disable reporting by removing this from your `.runsettings` or by setting it to false. 
+    - **Default Value**: true
+    - **Example**:
+      ```xml
+      <Logger friendlyName="microsoft-playwright-testing" enabled="True" />
+      ```
+::: zone-end
 ## Related content
 
 - Learn more about [Microsoft Playwright Testing preview pricing](https://aka.ms/mpt/pricing).
diff --git a/articles/playwright-testing/quickstart-automate-end-to-end-testing.md b/articles/playwright-testing/quickstart-automate-end-to-end-testing.md
@@ -240,59 +240,59 @@ Update the CI workflow definition to run your Playwright tests with the Playwrig
     # [GitHub Actions](#tab/github)
 
     ```yml
-  on:
-    push:
-      branches: [ main, master ]
-    pull_request:
-      branches: [ main, master ]
-  permissions: # Required when using AuthType as EntraId
-    id-token: write
-    contents: read
-  jobs:
-    test:
-      timeout-minutes: 60
-      runs-on: ubuntu-latest
-        steps:
-        - uses: actions/checkout@v4
-      # This step is to sign-in to Azure to run tests from GitHub Action workflow. 
-      # Choose how to set up authentication to Azure from GitHub Actions. This is one example. 
-        
-        - name: Login to Azure with AzPowershell (enableAzPSSession true) 
-          uses: azure/login@v2 
-          with: 
-            client-id: ${{ secrets.AZURE_CLIENT_ID }} 
-            tenant-id: ${{ secrets.AZURE_TENANT_ID }}  
-            subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}  
-            enable-AzPSSession: true 
-        
-        - name: Setup .NET
-          uses: actions/setup-dotnet@v4
-          with:
-            dotnet-version: 8.0.x
-        
-        - name: Restore dependencies
-          run: dotnet restore
-          working-directory: path/to/playwright/folder # update accordingly
-        
-        - name: Build
-          run: dotnet build --no-restore
-          working-directory: path/to/playwright/folder # update accordingly
-
-        - name: Run Playwright tests
+    on:
+      push:
+        branches: [ main, master ]
+      pull_request:
+        branches: [ main, master ]
+    permissions: # Required when using AuthType as EntraId
+      id-token: write
+      contents: read
+    jobs:
+      test:
+        timeout-minutes: 60
+        runs-on: ubuntu-latest
+          steps:
+          - uses: actions/checkout@v4
+        # This step is to sign-in to Azure to run tests from GitHub Action workflow. 
+        # Choose how to set up authentication to Azure from GitHub Actions. This is one example. 
+          
+          - name: Login to Azure with AzPowershell (enableAzPSSession true) 
+            uses: azure/login@v2 
+            with: 
+              client-id: ${{ secrets.AZURE_CLIENT_ID }} 
+              tenant-id: ${{ secrets.AZURE_TENANT_ID }}  
+              subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}  
+              enable-AzPSSession: true 
+          
+          - name: Setup .NET
+            uses: actions/setup-dotnet@v4
+            with:
+              dotnet-version: 8.0.x
+          
+          - name: Restore dependencies
+            run: dotnet restore
             working-directory: path/to/playwright/folder # update accordingly
-          env:
-            # Regional endpoint for Microsoft Playwright Testing
-            PLAYWRIGHT_SERVICE_URL: ${{ secrets.PLAYWRIGHT_SERVICE_URL }}
-            PLAYWRIGHT_SERVICE_RUN_ID: ${{ github.run_id }}-${{ github.run_attempt }}-${{ github.sha }}
-          run: dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20
-
-        - name: Upload Playwright report
-          uses: actions/upload-artifact@v3
-          if: always()
-          with:
-            name: playwright-report
-            path: path/to/playwright/folder/playwright-report/ # update accordingly
-            retention-days: 10
+          
+          - name: Build
+            run: dotnet build --no-restore
+            working-directory: path/to/playwright/folder # update accordingly
+
+          - name: Run Playwright tests
+              working-directory: path/to/playwright/folder # update accordingly
+            env:
+              # Regional endpoint for Microsoft Playwright Testing
+              PLAYWRIGHT_SERVICE_URL: ${{ secrets.PLAYWRIGHT_SERVICE_URL }}
+              PLAYWRIGHT_SERVICE_RUN_ID: ${{ github.run_id }}-${{ github.run_attempt }}-${{ github.sha }}
+            run: dotnet test --settings:.runsettings --logger "microsoft-playwright-testing" -- NUnit.NumberOfTestWorkers=20
+
+          - name: Upload Playwright report
+            uses: actions/upload-artifact@v3
+            if: always()
+            with:
+              name: playwright-report
+              path: path/to/playwright/folder/playwright-report/ # update accordingly
+              retention-days: 10
     ```
 
     # [Azure Pipelines](#tab/pipelines)
