Struct ChromiumEngine 

pub struct ChromiumEngine { /* private fields */ }

A real Chromium process. Initialization errors are returned to the caller; this type never creates a simulated engine or weakens Chromium’s sandbox.

Implementations

impl ChromiumEngine

pub fn new() -> Result<Arc<ChromiumEngine>, String>

Start the packaged runtime and persistent local profile.

Errors

Returns an error if the runtime/profile cannot be located, prepared, or initialized.

pub fn new_with_extensions( extensions: &[PathBuf], ) -> Result<Arc<ChromiumEngine>, String>

Errors

Returns an error for invalid extensions, unavailable runtime/profile, or helper initialization failure.

pub fn new_private(root: &Path) -> Result<Arc<ChromiumEngine>, String>

Errors

Returns an error if the private root is not owned, the runtime is missing, or initialization fails.

pub fn with_profile_extensions( profile: &Path, extensions: &[PathBuf], ) -> Result<Arc<ChromiumEngine>, String>

Explicit profile with the packaged helper and approved extensions.

Errors

Returns an error for invalid extensions, profile preparation failure, or helper startup/initialization failure.

pub fn with_host( host: &Path, profile: &Path, ) -> Result<Arc<ChromiumEngine>, String>

Explicit runtime/profile paths for packaging and isolated live tests.

Errors

Returns an error if the profile cannot be prepared or the helper cannot start and initialize.

pub fn with_private_host( host: &Path, root: &Path, ) -> Result<Arc<ChromiumEngine>, String>

Start an incognito helper whose complete installation root is removed by the process supervisor only after the native child has exited.

Errors

Returns an error if the private root is not owned, the profile cannot be prepared, or the helper cannot initialize.

Trait Implementations

impl Drop for ChromiumEngine

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.

impl WebViewEngine for ChromiumEngine

fn handle_undo_request(&self, request: UndoRequest) -> bool

Offer system Undo/Redo to this page’s native editing history. True means the backend consumed the request, not that a history entry existed or that an asynchronous edit has already completed.

fn supports_guarded_edit_history(&self) -> bool

Whether original-field acknowledged Undo/Redo is supported.

fn supports_text_input(&self) -> bool

fn text_input(&self, request: Request) -> Option<Receipt>

Private text transactions never enter the app event or page-agent stream.

fn navigate_owned( &self, request_id: u32, command: NavigationCommand, ) -> Result<(), String>

Admit a navigation and reserve its terminal outcome. IDs must increase strictly within this engine’s lifetime and fit a positive CEF signed integer.

fn create_tab(&self) -> Result<Arc<dyn WebViewEngine>, String>

Create an independent document in the same runtime/profile.

fn set_modifiers(&self, modifiers: KeyModifiers)

Keep pointer modifiers current even when no key event reaches the page.

fn set_visible(&self, visible: bool)

Suspend painting without discarding the document or its session history.

fn take_new_tab_requests(&self) -> Vec<(String, bool)>

Native new-window intents, delivered to browser chrome as tab requests.

fn supports_native_filtering(&self) -> bool

Whether this backend accepts source rules instead of WebKit JSON.

fn send(&self, command: WebViewCommand)

Enqueue a command. Must never block on engine work.

fn frames(&self) -> Arc<Mutex<Option<Frame>>>

fn drain_events(&self) -> Vec<WebViewEvent>

Take all pending events, oldest first.

fn request_close(&self) -> bool

Request native close admission. True allows immediate local close; false completes asynchronously through TabClosed, TabDetached or TabCloseBlocked.

fn drain_download_events(&self) -> Vec<WebViewEvent>

Runtime-owned download events, independent of a tab lifetime.

fn set_waker(&self, waker: Box<dyn Fn() + Send + Sync>)

Invoked (from any thread) whenever a new frame or event is ready — typically wired to the winit event loop proxy so idle apps repaint on engine activity. Synchronous engines don’t need one.

fn presented(&self)

A view drew this engine’s page just now. Engines that stop painting pages nobody draws (see paint::PaintEngine) resume here.

fn wrapped(&self) -> Option<&Arc<dyn WebViewEngine>>

The engine this one wraps, for what only a backend can answer.

fn paint_frame(&self) -> Option<Arc<Frame>>

The page as a display list. An engine that has one is drawn from it instead of frames (see paint).

fn paint_blob(&self, _hash: &[u8; 32]) -> Option<Arc<Vec<u8>>>

Encoded bytes of an image a paint_frame references.

fn take_paint_stream(&self, _keyframe: bool) -> Vec<Payload>

The page as a stream for a session to share: a whole frame when keyframe (or when the consumer must start over), else the patches since the last call, followed by images not sent yet. Empty for an engine without a display list.