feat: Use specialized Playwright docker images in templates (#1757)

### Description

- Update templates to use a browser-specialized Playwright Docker image
- Add specialized templates: `playwright-chrome`, `playwright-firefox`,
`playwright-webkit`
- Update e2e tests to include new templates
- Update `PlaywrightBrowserPlugin` to not raise an Exception when
browser `type='chrome'` and explicit `executable_path` is provided as
well. Just add debug log instead.

### Issues

- Closes: #1756

### Testing

- e2e tests

### Checklist

- [ ] CI passed

Author: Pijukatel

.github/workflows/on_schedule_tests.yaml

@@ -24,8 +24,8 @@ jobs:
       fail-fast: false
       max-parallel: 12
       matrix:
-        crawler-type: ["playwright_camoufox", "playwright", "parsel", "beautifulsoup"]
-        http-client: [ "httpx", "curl_impersonate"]
+        crawler-type: ["playwright_camoufox", "playwright_chrome", "playwright_firefox", "playwright_webkit", "playwright", "parsel", "beautifulsoup"]
+        http-client: ["httpx", "curl_impersonate"]
         package-manager: ["pip", "uv", "poetry"]
 
     runs-on: "ubuntu-latest"

src/crawlee/browsers/_playwright_browser_plugin.py

@@ -82,20 +82,23 @@ def __init__(
             'executable_path': config.default_browser_path,
             'chromium_sandbox': not config.disable_browser_sandbox,
         }
-
-        if browser_type == 'chrome' and default_launch_browser_options['executable_path']:
-            raise ValueError(
-                'Cannot use browser_type `chrome` with `Configuration.default_browser_path` or `executable_path` set.'
-            )
+        explicit_browser_launch_options = browser_launch_options or {}
 
         # Map 'chrome' to 'chromium' with the 'chrome' channel.
         if browser_type == 'chrome':
             browser_type = 'chromium'
             # Chromium parameter 'channel' set to 'chrome' enables using installed Google Chrome.
             default_launch_browser_options['channel'] = 'chrome'
 
+            if executable_path := explicit_browser_launch_options.get(
+                'executable_path', default_launch_browser_options.get('executable_path')
+            ):
+                logger.debug(
+                    f"Using browser executable from {executable_path}, which takes precedence over 'chrome' channel."
+                )
+
         self._browser_type: BrowserType = browser_type
-        self._browser_launch_options: dict[str, Any] = default_launch_browser_options | (browser_launch_options or {})
+        self._browser_launch_options: dict[str, Any] = default_launch_browser_options | explicit_browser_launch_options
         self._browser_new_context_options = browser_new_context_options or {}
         self._max_open_pages_per_browser = max_open_pages_per_browser
         self._use_incognito_pages = use_incognito_pages

src/crawlee/project_template/cookiecutter.json

@@ -1,7 +1,7 @@
 {
     "project_name": "crawlee-python-project",
     "__package_name": "{{ cookiecutter.project_name|lower|replace('-', '_') }}",
-    "crawler_type": ["beautifulsoup", "parsel", "playwright", "playwright-camoufox"],
+    "crawler_type": ["beautifulsoup", "parsel", "playwright", "playwright-camoufox", "playwright-chrome", "playwright-firefox", "playwright-webkit"],
     "__crawler_type": "{{ cookiecutter.crawler_type|lower|replace('-', '_') }}",
     "http_client": ["impit", "httpx", "curl-impersonate"],
     "package_manager": ["poetry", "pip", "uv"],

src/crawlee/project_template/templates/main_playwright_chrome.py

@@ -0,0 +1,15 @@
+# % extends 'main.py'
+
+# % block import
+from crawlee.crawlers import PlaywrightCrawler
+# % endblock
+
+# % block instantiation
+crawler = PlaywrightCrawler(
+    request_handler=router,
+    headless=True,
+    max_requests_per_crawl=10,
+    browser_type="chrome",
+    {{ self.http_client_instantiation() }}
+)
+# % endblock

src/crawlee/project_template/templates/main_playwright_firefox.py

@@ -0,0 +1,15 @@
+# % extends 'main.py'
+
+# % block import
+from crawlee.crawlers import PlaywrightCrawler
+# % endblock
+
+# % block instantiation
+crawler = PlaywrightCrawler(
+    request_handler=router,
+    headless=True,
+    max_requests_per_crawl=10,
+    browser_type="firefox",
+    {{ self.http_client_instantiation() }}
+)
+# % endblock

src/crawlee/project_template/templates/main_playwright_webkit.py

@@ -0,0 +1,15 @@
+# % extends 'main.py'
+
+# % block import
+from crawlee.crawlers import PlaywrightCrawler
+# % endblock
+
+# % block instantiation
+crawler = PlaywrightCrawler(
+    request_handler=router,
+    headless=True,
+    max_requests_per_crawl=10,
+    browser_type="webkit",
+    {{ self.http_client_instantiation() }}
+)
+# % endblock

src/crawlee/project_template/templates/routes_camoufox.py

@@ -4,8 +4,13 @@
 # % if cookiecutter.crawler_type == 'playwright'
 FROM apify/actor-python-playwright:3.13
 # % elif cookiecutter.crawler_type == 'playwright-camoufox'
-# Currently camoufox has issues installing on Python 3.13
-FROM apify/actor-python-playwright:3.12
+FROM apify/actor-python-playwright-camoufox:3.13
+# % elif cookiecutter.crawler_type == 'playwright-chrome'
+FROM apify/actor-python-playwright-chrome:3.13
+# % elif cookiecutter.crawler_type == 'playwright-firefox'
+FROM apify/actor-python-playwright-firefox:3.13
+# % elif cookiecutter.crawler_type == 'playwright-webkit'
+FROM apify/actor-python-playwright-webkit:3.13
 # % else
 FROM apify/actor-python:3.13
 # % endif

src/crawlee/project_template/templates/routes_playwright_camoufox.py

@@ -1,4 +1,4 @@
-# % if cookiecutter.crawler_type == 'playwright-camoufox'
+# % if cookiecutter.crawler_type.startswith('playwright')
 # % set extras = ['playwright']
 # % else
 # % set extras = [cookiecutter.crawler_type]