playwright_rs/protocol/
keyboard.rs

1// Keyboard - Low-level keyboard control
2//
3// See: https://playwright.dev/docs/api/class-keyboard
4
5use crate::error::Result;
6use crate::protocol::page::Page;
7
8/// Keyboard provides low-level keyboard control.
9///
10/// See: <https://playwright.dev/docs/api/class-keyboard>
11#[derive(Clone)]
12pub struct Keyboard {
13    page: Page,
14}
15
16impl Keyboard {
17    /// Creates a new Keyboard instance for the given page
18    pub(crate) fn new(page: Page) -> Self {
19        Self { page }
20    }
21
22    /// Dispatches a `keydown` event.
23    ///
24    /// See: <https://playwright.dev/docs/api/class-keyboard#keyboard-down>
25    pub async fn down(&self, key: &str) -> Result<()> {
26        self.page.keyboard_down(key).await
27    }
28
29    /// Dispatches a `keyup` event.
30    ///
31    /// See: <https://playwright.dev/docs/api/class-keyboard#keyboard-up>
32    pub async fn up(&self, key: &str) -> Result<()> {
33        self.page.keyboard_up(key).await
34    }
35
36    /// Executes a complete key press (down + up sequence).
37    ///
38    /// See: <https://playwright.dev/docs/api/class-keyboard#keyboard-press>
39    pub async fn press(
40        &self,
41        key: &str,
42        options: Option<crate::protocol::KeyboardOptions>,
43    ) -> Result<()> {
44        self.page.keyboard_press(key, options).await
45    }
46
47    /// Sends a `keydown`, `keypress`/`input`, and `keyup` event for each character.
48    ///
49    /// See: <https://playwright.dev/docs/api/class-keyboard#keyboard-type>
50    pub async fn type_text(
51        &self,
52        text: &str,
53        options: Option<crate::protocol::KeyboardOptions>,
54    ) -> Result<()> {
55        self.page.keyboard_type(text, options).await
56    }
57
58    /// Dispatches only `input` event, does not emit `keydown`, `keyup` or `keypress` events.
59    ///
60    /// See: <https://playwright.dev/docs/api/class-keyboard#keyboard-insert-text>
61    pub async fn insert_text(&self, text: &str) -> Result<()> {
62        self.page.keyboard_insert_text(text).await
63    }
64}
playwright_rs/protocol/keyboard.rs

playwright_rs/protocol/
keyboard.rs
