gh-cskiro-claudex/skills/benchmarking/html-to-png-converter/reference/playwright-cli.md

Playwright CLI Reference

Screenshot Command

playwright screenshot [options] <url> <output>

Options

Option	Description	Default
--full-page	Capture full scrollable page	Off (viewport only)
--viewport-size=WxH	Set viewport size	800x600
--scale=N	Device scale factor	1
--wait-for-timeout=ms	Wait before screenshot	0
--wait-for-selector=sel	Wait for element	None
--color-scheme=mode	light or dark	System
--device=name	Emulate device	None
--timeout=ms	Navigation timeout	30000
--browser=name	Browser to use	chromium

Browser Options

# Use specific browser
playwright screenshot --browser=firefox "file://$(pwd)/diagram.html" output.png
playwright screenshot --browser=webkit "file://$(pwd)/diagram.html" output.png
playwright screenshot --browser=chromium "file://$(pwd)/diagram.html" output.png

Device Emulation

# Emulate specific device
playwright screenshot --device="iPhone 12" "file://$(pwd)/diagram.html" output.png
playwright screenshot --device="iPad Pro" "file://$(pwd)/diagram.html" output.png

List all devices:

playwright devices

Examples

Basic Full Page

playwright screenshot --full-page "file://$(pwd)/diagram.html" output.png

High Resolution (2x)

playwright screenshot --full-page --scale=2 "file://$(pwd)/diagram.html" output@2x.png

Dark Mode

playwright screenshot --full-page --color-scheme=dark "file://$(pwd)/diagram.html" dark.png

Custom Viewport

playwright screenshot --viewport-size=1920x1080 "file://$(pwd)/diagram.html" output.png

Wait for Content

# Wait 2 seconds for dynamic content
playwright screenshot --full-page --wait-for-timeout=2000 "file://$(pwd)/diagram.html" output.png

# Wait for specific element
playwright screenshot --full-page --wait-for-selector=".loaded" "file://$(pwd)/diagram.html" output.png

PDF Generation (Alternative)

For PDF output instead of PNG:

playwright pdf "file://$(pwd)/document.html" output.pdf

PDF-specific options:

• --format=Letter|A4|...
• --landscape
• --margin=top,right,bottom,left
• --print-background

Installation Commands

# Install Playwright
npm install -g playwright

# Install browsers
playwright install              # All browsers
playwright install chromium     # Chromium only
playwright install firefox      # Firefox only
playwright install webkit       # WebKit only

# Check version
playwright --version