Skip to content

Commit f20c696

Browse files
Merge pull request #303999 from MicrosoftDocs/main
Auto Publish – main to live - 2025-08-07 22:00 UTC
2 parents f7d051d + 1b18b5b commit f20c696

28 files changed

+506
-154
lines changed

articles/app-testing/playwright-workspaces/concept-determine-optimal-configuration.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -122,7 +122,7 @@ Experiment with the number of parallel workers to run your tests. Measure the te
122122
Notice at which point the test completion time no longer reduces as you add more workers. Move to the next step to further optimize your setup.
123123

124124
> [!NOTE]
125-
> While the service is in preview, the number of [parallel workers per workspace is limited](./resource-limits-quotas-capacity.md) to 50. You can [request an increase of this limit for your workspace](https://aka.ms/mpt/feedback).
125+
> While the service is in preview, the number of [parallel workers per workspace is limited](./resource-limits-quotas-capacity.md) to 50. You can [request an increase of this limit for your workspace](https://aka.ms/pww/feedback).
126126
127127
### 6. Scale the client
128128

articles/app-testing/playwright-workspaces/how-to-configure-visual-comparisons.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -53,7 +53,7 @@ import { getServiceConfig, ServiceOS } from '@azure/playwright';
5353
import { DefaultAzureCredential } from '@azure/identity';
5454
import config from './playwright.config';
5555

56-
/* Learn more about service configuration at https://aka.ms/mpt/config */
56+
/* Learn more about service configuration at https://aka.ms/pww/docs/config */
5757
export default defineConfig(
5858
config,
5959
getServiceConfig(config, {

articles/app-testing/playwright-workspaces/how-to-manage-authentication.md

Lines changed: 9 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ author: ninallam
99
ms.author: ninallam
1010
ms.date: 08/07/2025
1111
ms.custom: playwright-workspaces-preview
12-
zone_pivot_group_filename: playwright-workspaces/zone-pivots-groups.json
12+
zone_pivot_group_filename: app-testing/playwright-workspaces/zone-pivots-groups.json
1313
zone_pivot_groups: playwright-workspaces
1414
---
1515

@@ -55,24 +55,20 @@ To enable authentication using access tokens:
5555

5656
::: zone pivot="playwright-test-runner"
5757

58-
### If you're using the **Playwright Test Runner**
58+
1. While running the tests, enable access token auth in the `playwright.service.config.ts` file in your setup.
5959

60-
While running the tests, enable access token auth in the `playwright.service.config.ts` file in your setup.
61-
62-
```typescript
60+
```typescript
6361
import { getServiceConfig, ServiceAuth } from '@azure/playwright';
6462

65-
/* Learn more about service configuration at https://aka.ms/mpt/config */
66-
export default defineConfig(config, getServiceConfig( config {
63+
/* Learn more about service configuration at https://aka.ms/pww/docs/config */
64+
export default defineConfig(config, getServiceConfig( config, {
6765
serviceAuthType: ServiceAuth.ACCESS_TOKEN
6866
}));
69-
```
67+
```
7068
::: zone-end
7169

7270
::: zone pivot="nunit-test-runner"
7371

74-
### If you're using the **NUnit Test Runner**
75-
7672
1. While running the tests, enable access token auth in the setup file.
7773

7874
```c#
@@ -91,7 +87,7 @@ While running the tests, enable access token auth in the `playwright.service.con
9187
credential: new DefaultAzureCredential(),
9288
options: new PlaywrightServiceBrowserClientOptions()
9389
{
94-
90+
ServiceAuth = ServiceAuthType.AccessToken
9591
}
9692
)
9793
{
@@ -109,8 +105,6 @@ While running the tests, enable access token auth in the `playwright.service.con
109105

110106
## Set up your environment.
111107

112-
### If you're using the **Playwright Test Runner**
113-
114108
To set up your environment, configure the `PLAYWRIGHT_SERVICE_ACCESS_TOKEN` environment variable with the value you obtained in the previous steps. Ensure this environment variable is available in your setup where you are running tests.
115109

116110
We recommend that you use the `dotenv` module to manage your environment. With `dotenv`, you define your environment variables in the `.env` file.
@@ -133,27 +127,23 @@ We recommend that you use the `dotenv` module to manage your environment. With `
133127

134128
::: zone pivot="nunit-test-runner"
135129

136-
### If you're using the **NUnit Test Runner**
137-
138130
To set up your environment, configure the `PLAYWRIGHT_SERVICE_ACCESS_TOKEN` environment variable with the value you obtained in the previous steps. Ensure this environment variable is available in your setup where you are running tests.
139131

140132
::: zone-end
141133

142-
## Run tests on the service and publish results
134+
## Run tests on the service
143135

144-
Run Playwright tests against cloud-hosted browsers and publish the results to the service using the configuration you created above.
136+
Run Playwright tests against cloud-hosted browsers using the configuration you created above.
145137

146138
::: zone pivot="playwright-test-runner"
147139

148-
### If you're using the **Playwright Test Runner**
149140
```typescript
150141
npx playwright test --config=playwright.service.config.ts --workers=20
151142
```
152143
::: zone-end
153144

154145
::: zone pivot="nunit-test-runner"
155146

156-
### If you're using the **NUnit Test Runner**
157147
```bash
158148
dotnet test -- NUnit.NumberOfTestWorkers=20
159149
```

articles/app-testing/playwright-workspaces/how-to-test-local-applications.md

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.subservice: playwright-workspaces
99
author: ninallam
1010
ms.author: ninallam
1111
ms.custom: playwright-workspaces-preview
12-
zone_pivot_group_filename: playwright-workspaces/zone-pivots-groups.json
12+
zone_pivot_group_filename: app-testing/playwright-workspaces/zone-pivots-groups.json
1313
zone_pivot_groups: playwright-workspaces
1414
---
1515

@@ -30,8 +30,6 @@ You can specify one or multiple networks by using a list of rules. For example,
3030

3131
::: zone pivot="playwright-test-runner"
3232

33-
### If you're using the **Playwright Test Runner**
34-
3533
You can configure the `exposeNetwork` option in `playwright.service.config.ts`. The following example shows how to expose the `localhost` network by using the [`<loopback>`](https://en.wikipedia.org/wiki/Loopback) rule. You can also replace `localhost` with a domain that you want to enable for the service.
3634

3735
```typescript
@@ -60,8 +58,6 @@ npx playwright test --config=playwright.service.config.ts --workers=20
6058

6159
::: zone pivot="nunit-test-runner"
6260

63-
### If you're using the **NUnit Test Runner**
64-
6561
You can configure the `ExposeNetwork` option in the setup file. The following example shows how to expose the `localhost` network by using the [`<loopback>`](https://en.wikipedia.org/wiki/Loopback) rule. You can also replace `localhost` with a domain that you want to enable for the service.
6662

6763
```c#

articles/app-testing/playwright-workspaces/how-to-use-service-config-file.md

Lines changed: 1 addition & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,25 +9,21 @@ ms.subservice: playwright-workspaces
99
author: ninallam
1010
ms.author: ninallam
1111
ms.custom: playwright-workspaces-preview
12-
zone_pivot_group_filename: playwright-workspaces/zone-pivots-groups.json
12+
zone_pivot_group_filename: app-testing/playwright-workspaces/zone-pivots-groups.json
1313
zone_pivot_groups: playwright-workspaces
1414
---
1515

1616
# Use options available in service package with Playwright Workspaces
1717

1818
::: zone pivot="playwright-test-runner"
1919

20-
### If you're using the **Playwright Test Runner**
21-
2220
This article shows you how to use the options available in the `playwright.service.config.ts` file that was generated for you.
2321
If you don't have this file in your code, follow [Quickstart: Run end-to-end tests at scale with Playwright Workspaces](./quickstart-run-end-to-end-tests.md)
2422

2523
::: zone-end
2624

2725
::: zone pivot="nunit-test-runner"
2826

29-
### If you're using the **NUnit Test Runner**
30-
3127
This article shows you how to use the options available in the `PlaywrightServiceSetup.cs` file.
3228
If you don't have this file in your code, follow [Quickstart: Run end-to-end tests at scale with Playwright Workspaces](./quickstart-run-end-to-end-tests.md)
3329

@@ -42,8 +38,6 @@ If you don't have this file in your code, follow [Quickstart: Run end-to-end tes
4238

4339
::: zone pivot="playwright-test-runner"
4440

45-
### If you're using the **Playwright Test Runner**
46-
4741
Below is a complete example of a `playwright.service.config.ts` file showing all supported configuration options:
4842

4943
```typescript
@@ -131,8 +125,6 @@ export default defineConfig(
131125

132126
::: zone pivot="nunit-test-runner"
133127

134-
### If you're using the **NUnit Test Runner**
135-
136128

137129
Here's version of the setup file with all the available options:
138130

articles/app-testing/playwright-workspaces/quickstart-automate-end-to-end-testing.md

Lines changed: 2 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.subservice: playwright-workspaces
99
author: ninallam
1010
ms.author: ninallam
1111
ms.custom: playwright-workspaces-preview
12-
zone_pivot_group_filename: playwright-workspaces/zone-pivots-groups.json
12+
zone_pivot_group_filename: app-testing/playwright-workspaces/zone-pivots-groups.json
1313
zone_pivot_groups: playwright-workspaces
1414
---
1515

@@ -67,8 +67,6 @@ To get the service endpoint URL and store it as a CI workflow secret, perform th
6767

6868
## Add service configuration file
6969

70-
### If you're using the **Playwright Test Runner**
71-
7270
If you don't have Playwright tests configured to run with the service, add a service configuration file to your repository. In the next step, you then specify this service configuration file on the Playwright CLI.
7371

7472
1. Create a new file `playwright.service.config.ts` alongside the `playwright.config.ts` file.
@@ -99,8 +97,6 @@ Update the `package.json` file in your repository to add details about Playwrigh
9997

10098
## Install service package
10199

102-
### If you're using the **NUnit Test Runner**
103-
104100
In your project, install Playwright Workspaces package.
105101

106102
```PowerShell
@@ -111,7 +107,7 @@ This command updates your project's `csproj` file by adding the service package
111107

112108
```xml
113109
<ItemGroup>
114-
<PackageReference Include="Azure.Developer.Playwright.NUnit" Version="1.0.0-beta.1" />
110+
<PackageReference Include="Azure.Developer.Playwright.NUnit" Version="1.0.0-beta.2" />
115111
</ItemGroup>
116112
```
117113

@@ -223,7 +219,6 @@ You can generate an access token from your Playwright workspace and use it in yo
223219

224220
::: zone pivot="playwright-test-runner"
225221

226-
### If you're using the **Playwright Test Runner**
227222
Update the CI workflow definition to run your Playwright tests with the Playwright CLI. Pass the [service configuration file](#add-service-configuration-file) as an input parameter for the Playwright CLI. You configure your environment by specifying environment variables.
228223

229224
1. Open the CI workflow definition.
@@ -324,8 +319,6 @@ Update the CI workflow definition to run your Playwright tests with the Playwrig
324319
325320
::: zone pivot="nunit-test-runner"
326321
327-
### If you're using the **NUnit Test Runner**
328-
329322
Update the CI workflow definition to run your Playwright tests with the Playwright NUnit CLI. You configure your environment by specifying environment variables.
330323
331324
1. Open the CI workflow definition.

articles/app-testing/playwright-workspaces/quickstart-run-end-to-end-tests.md

Lines changed: 3 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,7 @@ ms.subservice: playwright-workspaces
99
author: ninallam
1010
ms.author: ninallam
1111
ms.custom: playwright-workspaces-preview
12-
zone_pivot_group_filename: playwright-workspaces/zone-pivots-groups.json
12+
zone_pivot_group_filename: app-testing/playwright-workspaces/zone-pivots-groups.json
1313
zone_pivot_groups: playwright-workspaces
1414
---
1515

@@ -70,8 +70,6 @@ To get started with running your Playwright tests on cloud browsers, you first n
7070

7171
::: zone pivot="playwright-test-runner"
7272

73-
### If you're using the **Playwright Test Runner**
74-
7573
To use the service, install the Playwright Workspaces package.
7674

7775
```npm
@@ -86,8 +84,6 @@ If you already have this file, the package asks you to overwrite it.
8684

8785
::: zone pivot="nunit-test-runner"
8886

89-
### If you're using the **NUnit Test Runner**
90-
9187
To use the service, install the Playwright Workspaces package.
9288

9389
```PowerShell
@@ -118,8 +114,6 @@ To get the service endpoint URL, perform the following steps:
118114

119115
## Set up your environment
120116

121-
### If you're using the **Playwright Test Runner**
122-
123117
To set up your environment, you have to configure the `PLAYWRIGHT_SERVICE_URL` environment variable with the value you obtained in the previous steps.
124118

125119
We recommend that you use the `dotenv` module to manage your environment. With `dotenv`, you define your environment variables in the `.env` file.
@@ -142,9 +136,7 @@ We recommend that you use the `dotenv` module to manage your environment. With `
142136

143137
::: zone pivot="nunit-test-runner"
144138

145-
## Set up service configuration
146-
147-
### If you're using the **NUnit Test Runner**
139+
## Set up service configuration
148140

149141
Create a file `PlaywrightServiceSetup.cs` in your project with the following content.
150142

@@ -165,7 +157,7 @@ public class PlaywrightServiceNUnitSetup : PlaywrightServiceBrowserNUnit
165157
```
166158

167159
> [!NOTE]
168-
> Make sure your project uses `Microsoft.Playwright.NUnit` version 1.47 or above.
160+
> Make sure your project uses `Microsoft.Playwright.NUnit` version 1.50 or above.
169161

170162
::: zone-end
171163
## Set up Authentication
@@ -202,8 +194,6 @@ You can generate an access token from your Playwright workspace and use it in yo
202194

203195
::: zone pivot="playwright-test-runner"
204196

205-
### If you're using the **Playwright Test Runner**
206-
207197
You've now prepared the configuration for running your Playwright tests in the cloud with Playwright Workspaces. You can either use the Playwright CLI to run your tests, or use the [Playwright Test Visual Studio Code extension](https://marketplace.visualstudio.com/items?itemName=ms-playwright.playwright).
208198
209199
### Run a single test with the service
@@ -334,8 +324,6 @@ To run your Playwright test suite in Visual Studio Code with Playwright Workspac
334324
335325
::: zone pivot="nunit-test-runner"
336326
337-
### If you're using the **NUnit Test Runner**
338-
339327
Run Playwright tests against browsers managed by the service using the configuration you created above.
340328
341329
```bash
@@ -364,13 +352,11 @@ With Playwright Workspaces, you can run with up to 50 parallel workers. Several
364352

365353
::: zone pivot="playwright-test-runner"
366354

367-
### If you're using the **Playwright Test Runner**
368355
You can specify the number of parallel workers on the Playwright CLI command-line, or configure the `workers` property in the Playwright service configuration file.
369356
::: zone-end
370357

371358
::: zone pivot="nunit-test-runner"
372359

373-
### If you're using the **NUnit Test Runner**
374360
You can specify the number of parallel workers on the Playwright CLI command-line, or configure the `NumberOfTestWorkers` property in the `.runsettings` file.
375361
::: zone-end
376362

articles/app-testing/playwright-workspaces/resource-limits-quotas-capacity.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -35,7 +35,7 @@ While the service is in preview, the following limits apply on a per-subscriptio
3535

3636
## Test code limitations
3737

38-
- The service supports Playwright OSS version 1.47 or higher.
38+
- The service supports Playwright OSS version 1.50 or higher.
3939
- The service supports the Playwright test runner and the NUnit test runner only.
4040

4141
## Supported operating systems and browsers

0 commit comments

Comments
 (0)