9 releases 9 tags

RSS feed

• v3.0.0 91b80de158

  Compare

  v3.0.0 - Playwright Migration 🚀 Stable

  jack released this 2025-10-11 08:57:34 +02:00 | 1 commits to main since this release

  🚀 Major Release - Playwright Migration

  This is a major upgrade migrating from Puppeteer to Playwright, bringing multi-browser support and modern automation capabilities.

  ✨ New Features

  Multi-Browser Support

  • 🌐 Chromium - Fast, feature-rich browser (default)
  • 🦊 Firefox - Mozilla's privacy-focused browser
  • 🧭 WebKit - Apple's browser engine (Safari)
  • 🔄 Switch browsers via BROWSER_TYPE environment variable
  • 📦 Automatic browser installation via playwright install

  Smart Viewport Management

  • 📐 Automatic 1920x1080 viewport in GUI mode (HEADLESS=false)
  • 🎯 Optimized viewing experience for non-headless browsing
  • 📏 Customizable viewport still available via setViewport tool

  🔄 Breaking Changes

  Migration from Puppeteer to Playwright

  • ⚡ New Engine: Playwright 1.56.0 replaces Puppeteer 22.0.0
  • 🎯 Modern API: Locator-based element interaction for better reliability
  • 🔌 CDP Access: Chromium DevTools Protocol still available for advanced features
  • 🌐 Context-based: Browser contexts for better isolation and management

  API Changes

  • Updated selector handling with Playwright's locator API
  • Improved network emulation with Playwright's native methods
  • Enhanced geolocation with built-in permission granting
  • Better wait strategies with waitForLoadState

  🛠️ Improvements

  Reliability

  • ✅ More stable element waiting and interaction
  • ✅ Better network idle detection
  • ✅ Improved error handling and timeout management
  • ✅ Modern async/await patterns throughout

  Type Safety

  • ✅ Full TypeScript compatibility with Playwright types
  • ✅ Better type inference for browser contexts
  • ✅ Proper typing for multi-parameter evaluate functions

  Developer Experience

  • ✅ Clearer console logging with browser detection
  • ✅ Better error messages
  • ✅ Automatic dependency management via postinstall

  📦 Dependencies

  • ➕ Added playwright@^1.56.0
  • ➖ Removed puppeteer@^22.0.0
  • ⬆️ Updated @modelcontextprotocol/sdk@^1.20.0

  🔧 Configuration

  New environment variable:

  • BROWSER_TYPE - Choose browser engine: chromium, firefox, or webkit (default: chromium)

  📝 Documentation

  • ✅ Updated README with Playwright information
  • ✅ Added multi-browser support documentation
  • ✅ Enhanced configuration examples
  • ✅ Updated all code examples for Playwright API

  ---

  See CHANGELOG.md for full details.

  Downloads

  • Source code (ZIP)
    0 downloads
  • Source code (TAR.GZ)
    0 downloads