Merge pull request #2656 from saucelabs/pw-webkit-note

Add note about the windows + webkit limitation

Author: mhan83

docs/web-apps/automated-testing/cucumberjs-playwright/limitations.md

@@ -0,0 +1,26 @@
+---
+id: limitations 
+title: Limitations for Cucumber.js with Playwright
+sidebar_label: Limitations
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import useBaseUrl from '@docusaurus/useBaseUrl';
+
+### Special Characters in Test Names
+
+We recommend that you avoid the use of special characters when naming your tests. If your test name contains any special characters, your test may not run or its artifacts may not be visible in our platform.
+
+### Playwright 1.31.1 + Webkit + Sauce-Connect
+
+When using Sauce-Connect, Webkit browser is unable to load any website that is hosted on the Internet.
+Local websites can still be loaded.
+
+### macOS 11 + Playwright 1.29+ + Webkit
+
+Webkit is not working on macOS 11 since Playwright 1.29.0
+
+### Webkit + Windows
+
+There is a [known issue](https://github.com/microsoft/playwright/issues/24512) in Playwright that prevents some sites from loading in Webkit on Windows with the error `SSL peer certificate or SSH remote key was not OK`. We recommend running your Playwright + Webkit tests on our Mac VMs by setting the [platformName](https://docs.saucelabs.com/web-apps/automated-testing/playwright/yaml/#platformname) to either `macOS 13` or `macOS 12`.

docs/web-apps/automated-testing/playwright.md

@@ -171,10 +171,6 @@ Local websites can still be loaded.
 
 Webkit is not working on macOS 11 since Playwright 1.29.0
 
-### Playwright + Cucumber
-
-Based on current Playwright test runner implementation, there is no way to run Playwright test runner with Cucumber.
-
 ### Playwright HTML Reporter + Trace Viewer
 
 Because of a limitation in how assets are stored on our platform, configuring your tests to use the built-in [HTML reporter](https://playwright.dev/docs/test-reporters#html-reporter) and Playwright's [Trace Viewer](https://playwright.dev/docs/trace-viewer-intro) feature will not work as expected.
@@ -188,3 +184,11 @@ browserType.launch: Chromium distribution 'chrome' is not found at C:\Users\sauc
 ```
 
 This is because playwright's project specific settings override the global configuration that Sauce Labs provides during runtime. In this case, the location of the browser binary. Make sure that `launchOptions` are not set when running on a Sauce VM.
+
+### Webkit + Windows
+
+There is a [known issue](https://github.com/microsoft/playwright/issues/24512) in Playwright that prevents some sites from loading in Webkit on Windows with the error `SSL peer certificate or SSH remote key was not OK`. We recommend running your Playwright + Webkit tests on our Mac VMs by setting the [platformName](https://docs.saucelabs.com/web-apps/automated-testing/playwright/yaml/#platformname) to either `macOS 13` or `macOS 12`.
+
+:::note
+Tests running through Sauce Tunnels are unaffected.
+:::

sidebars.js

@@ -1519,6 +1519,7 @@ module.exports = {
                                 'web-apps/automated-testing/cucumberjs-playwright/quickstart',
                                 'web-apps/automated-testing/cucumberjs-playwright/yaml',
                                 'web-apps/automated-testing/cucumberjs-playwright/advanced',
+                                'web-apps/automated-testing/cucumberjs-playwright/limitations',
                             ],
                         },
                         {