From ebcb37f61ed1fd5019a25150620064659b858853 Mon Sep 17 00:00:00 2001 From: Yury Semikhatsky Date: Thu, 30 Mar 2023 13:09:57 -0700 Subject: [PATCH] docs: add warning about browser policy (#22103) Fixes https://github.com/microsoft/playwright/issues/22016 --- docs/src/browsers.md | 4 ++++ docs/src/troubleshooting.md | 3 ++- 2 files changed, 6 insertions(+), 1 deletion(-) diff --git a/docs/src/browsers.md b/docs/src/browsers.md index 94431592cb..6e93701ab9 100644 --- a/docs/src/browsers.md +++ b/docs/src/browsers.md @@ -340,6 +340,10 @@ While Playwright can download and use the recent Chromium build, it can operate Available channels are `chrome`, `msedge`, `chrome-beta`, `msedge-beta` or `msedge-dev`. +:::warning +Certain Enterprise Browser Policies may impact Playwright's ability to launch and control Google Chrome and Microsoft Edge. Running in an environment with browser policies is outside of the Playwright project's scope. See [this page](./troubleshooting.md##incompatible-microsoft-edge--google-chrome-policy-settings) for some known issues. +::: + ```js import { defineConfig, devices } from '@playwright/test'; diff --git a/docs/src/troubleshooting.md b/docs/src/troubleshooting.md index 642fd4d05d..19e8f2fb3d 100644 --- a/docs/src/troubleshooting.md +++ b/docs/src/troubleshooting.md @@ -42,8 +42,9 @@ Running TypeScript tests in `"type": "module"` project requires Node.js 16 or hi It's known that Playwright is not working as expected when some Microsoft Edge / Google Chrome policy settings are set. The following shows some of them, there might be more that affect Playwright's functionalities. If you find any other policy settings that break functionality, please file an issue and we'll add it to this document. You can see a list of applied policies by running `chrome://policy` in the browser. -- `UserDataDir` - This policy is used to specify the location of the user data directory. Playwright uses a temporary directory for user data, so this policy is not compatible with Playwright. See discussion in [this bug](https://github.com/microsoft/playwright/issues/17448). +- `BrowserSignin` - This policy may prevent Playwright from launching the browser without signing in. Playwright will fail to launch browser if the policy forces users to sign-in to use the browser. See discussion in [this bug](https://github.com/microsoft/playwright/issues/22016) - `ExtensionInstallForcelist` - This policy is used to specify a list of extensions that should be installed. Playwright's browser close will not work if this policy is set. See discussion in [this bug](https://github.com/microsoft/playwright/issues/17299). +- `UserDataDir` - This policy is used to specify the location of the user data directory. Playwright uses a temporary directory for user data, so this policy is not compatible with Playwright. See discussion in [this bug](https://github.com/microsoft/playwright/issues/17448). ## .NET requirements * langs: csharp