Getting Started¶

Installation¶

uv add miniclient

Quick Tour¶

The API simulates a browser's user interaction with the Browser class:

from miniclient.browser import Browser

with Browser() as browser:
    browser.goto("http://localhost:8000/")
    browser.find("#load-more").click()
    print(browser.find("#results").text)

Filling in a form and submitting it works the same way, through fill() and requestSubmit():

from miniclient.browser import Browser

with Browser() as browser:
    browser.goto("http://localhost:8000/signup")
    browser.find("input[name=name]").fill("Ada")
    browser.find("input[name=email]").fill("ada@example.com")
    browser.find("form").requestSubmit()
    print(browser.find("#result").text)

For anything not covered by Browser / Element, you can run arbitrary JavaScript directly through eval():

from miniclient.browser import Browser

with Browser() as browser:
    browser.load("<h1 id='greeting'>Hello</h1>")
    print(browser.eval("document.getElementById('greeting').textContent"))
    browser.eval("document.getElementById('greeting').textContent = 'Hi!'")
    print(browser.find("#greeting").text)

Note: Browser doesn't expose a .runtime property the way AsyncBrowser does — use eval() instead.

Async usage¶

An AsyncBrowser equivalent is available for async codebases:

from miniclient.browser import AsyncBrowser

async with AsyncBrowser() as browser:
    await browser.goto("http://localhost:8000/")
    await browser.find("#load-more").click()
    print(browser.find("#results").text)