Add playwright to js-environments (#624)

Author: gmkumar2005

doc/project/js-environments.md

@@ -69,6 +69,58 @@ jsEnv := PhantomJSEnv(args = Seq("arg1", "arg2")).value
 For more options of the PhantomJS environment, see
 [the Scaladoc of `PhantomJSEnv`]({{ site.production_url }}/api/sbt-scalajs-env-phantomjs/1.0.0/org/scalajs/jsenv/phantomjs/sbtplugin/PhantomJSEnvPlugin$$autoImport$.html).
 
+## Playwright 
+[Playwright](https://playwright.dev/) is a comprehensive testing library, enabling automation of Chromium, Firefox, and WebKit browsers. 
+
+It supports multiple platforms and languages, including Mobile Web, making it an optimal choice for testing JavaScript in real browser environments. 
+
+[`scala-js-env-playwright`](https://github.com/gmkumar2005/scala-js-env-playwright) is an independent project that offers a `JSEnv` that uses Playwright for JavaScript execution.
+
+The playwright-based `jsEnv` can be enabled by adding the following settings in `build.sbt` 
+```scala
+jsEnv := new PWEnv(
+        browserName = "chrome",
+        headless = true,
+        showLogs = true
+    )
+```
+Addtionally it requires the following line in `project/plugins.sbt`:
+```scala
+// For Scala.js 1.x
+libraryDependencies += "io.github.gmkumar2005" %% "scala-js-env-playwright" % "0.1.8"
+```
+
+The `browserName` parameter accepts `chrome` , `chromium` , `firefox`, and `webkit` as possible options. 
+
+Please be aware that webkit support is currently in an experimental stage.
+
+### In browser debugging
+To maintain the browser window open post-execution, add the `withKeepAlive`  option into the environment.
+
+```scala
+lazy val pwenvConfig = Def.setting {
+  jsenv.playwright.PWEnv
+    .Config()
+    .withKeepAlive(true)
+}
+
+jsEnv := new jsenv.playwright.PWEnv(
+  browserName = "chrome",
+  headless = true,
+  showLogs = true,
+  pwenvConfig.value,
+)
+
+``` 
+### Headless Usage
+Running in headless mode is crucial for operations within Docker containers and build servers. 
+
+By default, `scala-js-env-playwright` operates in headless mode.
+However, for debugging purposes, you can set headless to `false`.
+
+## Details
+For more options of the plawwright environment see the github project [PlayWright-jsEnv](https://github.com/gmkumar2005/scala-js-env-playwright)
+
 ## Selenium
 
 [Selenium](http://docs.seleniumhq.org/) provides a programmatic interface to real browsers.

doc/tutorial/basic/index.md

@@ -351,7 +351,7 @@ After reloading, you can invoke `run` successfully:
     [info] Running tutorial.webapp.TutorialApp
     [success] (...)
 
-Alternatively to Node.js with jsdom, you can use [Selenium](http://docs.seleniumhq.org/).
+Alternatively to Node.js with jsdom, you can use [Selenium](http://docs.seleniumhq.org/) or [Playwright](https://github.com/gmkumar2005/scala-js-env-playwright)
 You can find more information about this in the [documentation about JavaScript environments]({{ BASE_PATH }}/doc/project/js-environments.html).
 
 ### Adding uTest