@nihan-vp/dev-auto

A lightweight, developer-focused browser automation framework developed by Nihan Ali VP, built using Chrome DevTools Protocol (CDP).

Designed for QA testing, automation workflows, and browser interaction on applications you own or have permission to test.

🚀 Overview

dev-auto is a custom-built automation engine that allows developers to:

• Control Chromium-based browsers
• Automate user interactions
• Test web applications
• Simulate multiple user sessions
• Build automation flows programmatically

It is a minimal yet powerful foundation for building advanced automation tools, testing frameworks, and browser agents.

⚠️ Usage Policy

This tool is intended strictly for:

• QA testing
• Automation of your own applications
• Development and learning purposes

Do NOT use for:

• Artificial traffic generation
• Platform manipulation
• Unauthorized automation

📦 Installation

npm install @nihan-vp/dev-auto

🧠 Basic Usage

const { chromium } = require("@nihan-vp/dev-auto");

(async () => {
  const browser = await chromium.launch({ headless: false });

  const context = await browser.newContext();
  const page = await context.newPage();

  await page.goto("https://example.com");
  await page.click("text=More information");

  await page.waitForTimeout(3000);

  await context.close();
  await browser.close();
})();

🔁 Multi-User Simulation (Testing Only)

const { chromium } = require("@nihan-vp/dev-auto");

(async () => {
  const browser = await chromium.launch({ headless: true });

  for (let i = 1; i <= 5; i++) {
    const context = await browser.newContext();
    const page = await context.newPage();

    const email = `user${Date.now()}${i}@test.com`;

    await page.goto("https://your-app.com");
    await page.click("text=Sign Up");
    await page.fill("#email", email);

    await context.close();
  }

  await browser.close();
})();

🧩 Core API

Browser

const browser = await chromium.launch(options);

Options:

• headless (boolean): Run browser in headless mode (default: false)
• executablePath (string): Custom browser executable path
• userDataDir (string): Profile directory for persistent sessions
• slowMo (number): Delay in milliseconds between actions

Context

const context = await browser.newContext();

Creates an isolated session with:

• Separate cookies
• Separate storage
• Independent user session

Page

const page = await context.newPage();

🔧 Supported Methods

Navigation

• await page.goto(url): Navigate to a URL
• await page.reload(): Reload the current page

Interaction

• await page.click(selector): Click an element (supports text= for text-based selection)
• await page.fill(selector, value): Fill an input field
• await page.press(key): Press a key (e.g., "Enter")

Evaluation

• await page.evaluate(script): Execute JavaScript in the page context

Timing

• await page.waitForTimeout(ms): Wait for a specified time

Screenshot

• await page.screenshot({ path: "file.png" }): Take a screenshot

⚙️ How It Works

dev-auto is built using:

• Chrome DevTools Protocol (CDP)
• WebSocket communication
• Node.js process control

Architecture:

Your Code
   ↓
dev-auto API
   ↓
Chrome DevTools Protocol
   ↓
Chromium Browser

🧪 Use Cases

• Web app QA testing
• Form automation
• UI validation
• Automation pipelines
• Personal automation tools
• Learning browser internals
• Building custom testing frameworks

🔮 Roadmap

Planned features:

• waitForSelector
• Better selector engine
• Real context isolation
• Recorder (record user actions)
• CLI tool (npx dev-auto)
• TypeScript support
• Headless performance improvements
• Parallel execution
• Visual Automation Studio (GUI)

📄 License

This project is licensed under the MIT License.

🤝 Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

👤 Author

Nihan Ali VP - Full-Stack Developer, IoT Innovator, and Creative Technologist from India.

📄 License

MIT License

⭐ Support

If you like this project:

Star the repo Share with developers Contribute ideas 📬 Contact

GitHub: https://github.com/nihan-vp

Portfolio: https://nihan-vp.me

⚡ Final Note

This is an early-stage automation framework built for learning and evolution.

Future goal: → Build a full Playwright-level system → Add UI automation studio → Create AI-powered browser agents