add click_with API for custom click behavior

CHANGELOG.md

@@ -14,6 +14,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 
 - Add `add_init_script` to `Page` for scripts before navigation
+- Add `click_with` to `Page` and `Element` for custom click behavior
 
 ## [0.8.0] 2025-11-28
 

chromiumoxide_types/src/lib.rs

@@ -266,3 +266,50 @@ impl From<String> for Binary {
         Self(expr)
     }
 }
+
+#[derive(Clone, Debug)]
+pub struct ClickOptions {
+    pub click_count: i64,
+}
+
+impl Default for ClickOptions {
+    fn default() -> Self {
+        Self { click_count: 1 }
+    }
+}
+
+impl ClickOptions {
+    pub fn new() -> Self {
+        Self::default()
+    }
+    pub fn builder() -> ClickOptionsBuilder {
+        ClickOptionsBuilder::default()
+    }
+}
+
+#[derive(Clone, Debug)]
+pub struct ClickOptionsBuilder {
+    click_count: i64,
+}
+
+impl Default for ClickOptionsBuilder {
+    fn default() -> Self {
+        Self { click_count: 1 }
+    }
+}
+
+impl ClickOptionsBuilder {
+    pub fn new() -> Self {
+        Self::default()
+    }
+    pub fn click_count(mut self, count: impl Into<i64>) -> Self {
+        self.click_count = count.into();
+        self
+    }
+
+    pub fn build(self) -> ClickOptions {
+        ClickOptions {
+            click_count: self.click_count,
+        }
+    }
+}

src/element.rs

@@ -4,6 +4,7 @@ use std::pin::Pin;
 use std::sync::Arc;
 use std::task::{Context, Poll};
 
+use chromiumoxide_types::ClickOptions;
 use futures::{future, Future, FutureExt, Stream};
 
 use chromiumoxide_cdp::cdp::browser_protocol::dom::{
@@ -267,7 +268,20 @@ impl Element {
     /// not exist anymore.
     pub async fn click(&self) -> Result<&Self> {
         let center = self.scroll_into_view().await?.clickable_point().await?;
-        self.tab.click(center).await?;
+        self.tab.click(center, ClickOptions::default()).await?;
+        Ok(self)
+    }
+
+    /// Clicks the element using the provided [`ClickOptions`].
+    ///
+    /// This behaves the same as [`click()`], but allows customizing
+    /// click behavior such as click count.
+    ///
+    /// Note that if the click triggers a navigation, this element
+    /// may no longer exist afterwards.
+    pub async fn click_with(&self,options: ClickOptions) -> Result<&Self> {
+        let center = self.scroll_into_view().await?.clickable_point().await?;
+        self.tab.click(center, options).await?;
         Ok(self)
     }
 

src/handler/page.rs

@@ -190,12 +190,12 @@ impl PageInner {
     }
 
     /// Performs a mouse click event at the point's location
-    pub async fn click(&self, point: Point) -> Result<&Self> {
+    pub async fn click(&self, point: Point, options: chromiumoxide_types::ClickOptions) -> Result<&Self> {
         let cmd = DispatchMouseEventParams::builder()
             .x(point.x)
             .y(point.y)
             .button(MouseButton::Left)
-            .click_count(1);
+            .click_count(options.click_count);
 
         self.move_mouse(point)
             .await?

src/page.rs

@@ -507,7 +507,7 @@ impl Page {
     /// immediately loaded when `click()` resolves. To wait until navigation is
     /// finished an additional `wait_for_navigation()` is required:
     ///
-    /// # Example
+    /// # Examples
     ///
     /// Trigger a navigation and wait until the triggered navigation is finished
     ///
@@ -521,10 +521,29 @@ impl Page {
     /// # }
     /// ```
     ///
-    /// # Example
     ///
-    /// Perform custom click
+    /// Use [`click_with()`] to perform a custom click:
+    /// 
+    /// ```no_run
+    /// # use chromiumoxide::page::Page;
+    /// # use chromiumoxide::error::Result;
+    /// # use chromiumoxide::layout::Point;
+    /// # use chromiumoxide::types::ClickOptions;
+    /// # async fn demo(page: Page, point: Point) -> Result<()> {
+    ///     let options = ClickOptions::builder()
+    ///         .click_count(2)
+    ///         .build();
+    ///
+    ///     page.click_with(point, options).await?;
+    ///     # Ok(())
+    /// # }
+    /// ```
+    ///
+    /// ## Advanced
     ///
+    /// For advanced use cases, the same behavior can be achieved manually by
+    /// issuing `DispatchMouseEventParams` commands directly via the CDP API.
+    /// 
     /// ```no_run
     /// # use chromiumoxide::page::Page;
     /// # use chromiumoxide::error::Result;
@@ -557,7 +576,51 @@ impl Page {
     /// # }
     /// ```
     pub async fn click(&self, point: Point) -> Result<&Self> {
-        self.inner.click(point).await?;
+        self.inner.click(point, ClickOptions::default()).await?;
+        Ok(self)
+    }
+
+    /// Performs a mouse click event at the point's location using the provided
+    /// [`ClickOptions`].
+    ///
+    /// This behaves the same as [`click()`], but allows customizing click behavior
+    /// such as click count or other click-related options.
+    ///
+    /// The point is scrolled into view first, then the corresponding
+    /// `DispatchMouseEventParams` commands are issued according to the supplied
+    /// options.
+    ///
+    /// Bear in mind that if `click_with()` triggers a navigation, the new page is
+    /// not immediately loaded when this function resolves. To wait until navigation
+    /// is finished, an additional [`wait_for_navigation()`] is required.
+    ///
+    /// # Example
+    ///
+    /// Perform a double click using [`ClickOptions`]
+    ///
+    /// ```no_run
+    /// # use chromiumoxide::page::Page;
+    /// # use chromiumoxide::error::Result;
+    /// # use chromiumoxide::layout::Point;
+    /// # use chromiumoxide::types::ClickOptions;
+    /// # async fn demo(page: Page, point: Point) -> Result<()> {
+    ///     let options = ClickOptions::builder()
+    ///         .click_count(2)
+    ///         .build();
+    ///
+    ///     page.click_with(point, options)
+    ///         .await?
+    ///         .wait_for_navigation()
+    ///         .await?;
+    ///     # Ok(())
+    /// # }
+    /// ```
+    pub async fn click_with(
+        &self,
+        point: Point,
+        options: ClickOptions,
+    ) -> Result<&Self> {
+        self.inner.click(point, options).await?;
         Ok(self)
     }
 
@@ -1411,3 +1474,4 @@ impl From<MediaTypeParams> for String {
         }
     }
 }
+