Input Domain

The Input domain provides methods for simulating mouse and keyboard input.

Import

const cdp = @import("cdp");
const Input = cdp.Input;
const MouseButton = cdp.MouseButton;
const MouseEventType = cdp.MouseEventType;

Initialization

var session = try browser.newPage();
var input = Input.init(session);

Mouse Methods

dispatchMouseEvent

Dispatch a mouse event.

pub fn dispatchMouseEvent(
    self: *Input,
    event_type: MouseEventType,
    x: f64,
    y: f64,
    options: MouseEventOptions,
) !void

Event Types:

pub const MouseEventType = enum {
    mousePressed,
    mouseReleased,
    mouseMoved,
    mouseWheel,
};

Options:

Field	Type	Description
button	?MouseButton	.left, .middle, .right
buttons	?i32	Button mask
click_count	?i32	Click count
delta_x	?f64	Wheel delta X
delta_y	?f64	Wheel delta Y
modifiers	?i32	Alt=1, Ctrl=2, Meta=4, Shift=8

click

Convenience method for clicking.

pub fn click(self: *Input, x: f64, y: f64, options: ClickOptions) !void

Example:

try input.click(100, 200, .{
    .button = .left,
    .click_count = 1,
});

doubleClick

Double-click at coordinates.

pub fn doubleClick(self: *Input, x: f64, y: f64, opts: ClickOptions) !void

Example:

try input.doubleClick(100, 200, .{});

moveTo

Move mouse to coordinates.

pub fn moveTo(self: *Input, x: f64, y: f64) !void

mouseDown

Press a mouse button at the given coordinates.

pub fn mouseDown(self: *Input, x: f64, y: f64, button: MouseButton) !void

Example:

// Press left button at (100, 200)
try input.mouseDown(100, 200, .left);

mouseUp

Release a mouse button at the given coordinates.

pub fn mouseUp(self: *Input, x: f64, y: f64, button: MouseButton) !void

Example:

// Release left button at (400, 200) — completes a drag
try input.mouseUp(400, 200, .left);

scroll

Scroll by delta (uses mouse wheel event).

pub fn scroll(self: *Input, delta_x: f64, delta_y: f64) !void

Example:

// Scroll down 300 pixels
try input.scroll(0, 300);

// Scroll up 200 pixels
try input.scroll(0, -200);

// Scroll right 100 pixels
try input.scroll(100, 0);

Keyboard Methods

dispatchKeyEvent

Dispatch a keyboard event.

pub fn dispatchKeyEvent(
    self: *Input,
    event_type: KeyEventType,
    options: KeyEventOptions,
) !void

Event Types:

pub const KeyEventType = enum {
    keyDown,
    keyUp,
    rawKeyDown,
    char,
};

Options:

Field	Type	Description
key	?[]const u8	Key value ("Enter", "a", etc.)
code	?[]const u8	Physical key code
text	?[]const u8	Text to input
modifiers	?i32	Modifier mask
windows_virtual_key_code	?i32	Windows VK code

type

Type text character by character.

pub fn type(self: *Input, text: []const u8) !void

Example:

try input.type("Hello, World!");

press

Press and release a key.

pub fn press(self: *Input, key: []const u8) !void

Example:

try input.press("Enter");
try input.press("Tab");
try input.press("Escape");

keyDown / keyUp

Press or release a key.

pub fn keyDown(self: *Input, key: []const u8, modifiers: ?i32) !void
pub fn keyUp(self: *Input, key: []const u8, modifiers: ?i32) !void

Common Key Names

Key	Name
Enter	"Enter"
Tab	"Tab"
Escape	"Escape"
Backspace	"Backspace"
Delete	"Delete"
Arrow keys	"ArrowUp", "ArrowDown", "ArrowLeft", "ArrowRight"
Home/End	"Home", "End"
Page Up/Down	"PageUp", "PageDown"

Modifier Masks

Combine with bitwise OR:

Modifier	Value
Alt	1
Ctrl	2
Meta (Cmd)	4
Shift	8

Example:

// Ctrl+A (Select All)
try input.keyDown("a", 2); // Ctrl=2
try input.keyUp("a", 2);

// Ctrl+Shift+S
try input.keyDown("s", 2 | 8); // Ctrl+Shift
try input.keyUp("s", 2 | 8);

Complete Example

const std = @import("std");
const cdp = @import("cdp");

pub fn main(init: std.process.Init) !void {
    const allocator = init.gpa;

    var browser = try cdp.Browser.launch(.{
        .headless = .off, // Visible for demo
        .allocator = allocator,
        .io = init.io,
    });
    defer browser.close();

    var session = try browser.newPage();
    defer session.detach() catch {};

    var page = cdp.Page.init(session);
    var dom = cdp.DOM.init(session);
    var input = cdp.Input.init(session);
    
    try page.enable();
    try dom.enable();

    _ = try page.navigate(allocator, "https://www.google.com");
    
    // Wait for load
    var i: u32 = 0;
    while (i < 1000000) : (i += 1) {
        std.atomic.spinLoopHint();
    }

    // Find search box and get its position
    const doc = try dom.getDocument(allocator, 1);
    const search_id = try dom.querySelector(doc.node_id, "textarea[name='q']");
    const box = try dom.getBoxModel(allocator, search_id);
    
    // Calculate center of element
    const x = @as(f64, @floatFromInt(box.content[0])) + @as(f64, @floatFromInt(box.width)) / 2;
    const y = @as(f64, @floatFromInt(box.content[1])) + @as(f64, @floatFromInt(box.height)) / 2;

    // Click on search box
    try input.click(x, y, .{});

    // Type search query
    try input.type("zchrome zig cdp");

    // Press Enter
    try input.press("Enter");
}