ChopChop — A browser automation library around
Chrome DevTools Protocol

nimble install chopchop

API reference

Key Features

• High-level library based on ChromeDevToolsProtocol package
• Browser automation - launch Chrome, navigate pages, extract content
• DOM querying - querySelector / querySelectorAll with full element access
• Mouse & keyboard - click, double-click, hover, drag & drop, type text, press keys
• JavaScript evaluation - evaluate / evaluateHandle with return values
• Navigation control - waitForNavigation, waitForSelector, multiple waitUntil modes (Load, DOMContentLoaded, NetworkIdle)
• Device emulation - viewport, user agent, geolocation
• Cookie management - get, set, delete, clear cookies
• Local & session storage - read/write via CDP
• Dialog handling - alert/confirm/prompt auto-accept or custom handlers
• Console capture - listen to browser console messages
• Network interception - route, fulfill, abort requests with glob patterns
• File uploads - setInputFiles on file inputs
• Select/dropdown - select by value, label, or index
• Screenshots - page screenshots as base64 data
• Isolated sessions - BrowserContext with separate cookies/storage per context
• Init scripts - inject JavaScript before page scripts run

Examples

...

Projects using ChopChop

• https://github.com/dfkup/dfkup - A VM + JIT compiled scripting language written in Nim {planned as a std/browser package}

❤ Contributions & Support

• 🐛 Found a bug? Create a new Issue
• 👋 Wanna help? Fork it!

	Switch to Open-Source LLMs via OpenCode GO, choosing from a variety of powerful models such as DeepSeek, Qwen, Kimi, GLM-5, MiniMax, MiMo. 🍕 Use our referral link to get started!

🎩 License

MIT license. Made by Humans from OpenPeeps.
Copyright OpenPeeps & Contributors — All rights reserved.