1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88
//! A high-level API for programmatically interacting with the [Chrome DevTools Protocol](https://chromedevtools.github.io/devtools-protocol/). //! //! This crate uses the [Chrome DevTools protocol] to drive/launch a Chromium or //! Chrome (potentially headless) browser. //! //! # Example //! ```no_run //! use futures::StreamExt; //! use chromiumoxide::{Browser, BrowserConfig}; //! //! #[async_std::main] //! async fn main() -> Result<(), Box<dyn std::error::Error>> { //! //! let (browser, mut handler) = //! Browser::launch(BrowserConfig::builder().with_head().build()?).await?; //! //! let handle = async_std::task::spawn(async move { //! loop { //! let _event = handler.next().await.unwrap(); //! } //! }); //! //! let page = browser.new_page("https://en.wikipedia.org").await?; //! //! // type into the search field and hit `Enter`, //! // this triggers a navigation to the search result page //! page.find_element("input#searchInput") //! .await? //! .click() //! .await? //! .type_str("Rust programming language") //! .await? //! .press_key("Enter") //! .await?; //! //! let html = page.wait_for_navigation().await?.content().await?; //! //! handle.await; //! Ok(()) //! } //! ``` //! //! The [`chromiumoxide_pdl`] crate contains a [PDL //! parser](chromiumoxide_pdl/src/pdl/parser.rs), which is a rust rewrite of a //! [python script in the chromium source tree]( https://chromium.googlesource.com/deps/inspector_protocol/+/refs/heads/master/pdl.py) and a //! [`Generator`](chromiumoxide_pdl/src/build/generator.rs) that turns the //! parsed PDL files into rust code. The //! [`chromiumoxide_cdp`](chromiumoxide_cdp) crate only purpose is to integrate //! the generator during is build process and include the generated output //! before compiling the crate itself. This separation is done merely because //! the generated output is ~60K lines of rust code (not including all the Proc //! macro extensions). So expect the compilation to take some time. //! //! The generator can be configured and used independently, see [`build.rs`] of //! [`chromiumoxide_cdp`]. //! //! [chromedp](https://github.com/chromedp/chromedp) //! [rust-headless-chrome](https://github.com/Edu4rdSHL/rust-headless-chrome) which the launch //! config, `KeyDefinition` and typing support is taken from. //! [puppeteer](https://github.com/puppeteer/puppeteer) #![warn(missing_debug_implementations, rust_2018_idioms)] /// reexport the generated cdp types pub use chromiumoxide_cdp::cdp; pub use chromiumoxide_types::{self as types, Binary, Command, Method, MethodType}; pub use crate::browser::{Browser, BrowserConfig}; pub use crate::conn::Connection; pub use crate::element::Element; pub use crate::error::Result; pub use crate::handler::Handler; pub use crate::page::Page; pub mod auth; pub mod browser; pub(crate) mod cmd; pub mod conn; pub mod element; pub mod error; pub mod fetcher; pub mod handler; pub mod js; pub mod keys; pub mod layout; pub mod listeners; pub mod page; pub(crate) mod utils;