Struct LaunchOptions

Source

pub struct LaunchOptions {
    pub width: u32,
    pub height: u32,
    pub headless: bool,
    pub extra_args: Vec<String>,
    pub profile_dir: Option<PathBuf>,
}

Expand description

Options for launching a ChromiumBackend.

headless = false shows a real visible Chromium window — intended for interactive flows like first-time authentication (LinkedIn, OAuth, SSO) where a human needs to complete sign-in / 2FA / captcha before the rest of the script runs headless against the persisted cookies.

Fields§

§width: u32§height: u32§headless: bool§extra_args: Vec<String>

Extra command-line flags appended to Chromium’s argv at launch. Use cases include the Google Meet bot (#112) which needs --use-fake-ui-for-media-stream, --autoplay-policy=no-user-gesture-required, and the container-friendly trio (--no-sandbox, --disable-dev-shm-usage, --disable-setuid-sandbox). Flags are passed verbatim — callers responsible for the correctness of what they append.

§profile_dir: Option<PathBuf>

Persistent Chromium profile to launch against, or None for the per-instance ephemeral tempdir that is this crate’s default.

This is how CAR code asks for persistence. It is an OPTION rather than an environment variable because the env var is process-global: one component setting it silently changed every other browser in the process, including browser.run’s per-connection browsers, which is how a drawer launch used to make every later browser.run die on SingletonLock. CAR_BROWSER_PROFILE_DIR remains the user-facing knob, read below when no explicit directory is given — but CAR code never writes it.

A directory already held by a live backend in this process is not an error: the launch falls back to the ephemeral default and logs, which starts a working (signed-out) browser instead of none at all. See crate::profile.

LaunchOptions

Struct LaunchOptions Copy item path

Fields§

Trait Implementations§

impl Clone for LaunchOptions

fn clone(&self) -> Self

fn clone_from(&mut self, source: &Self)

impl Debug for LaunchOptions

fn fmt(&self, f: &mut Formatter<'_>) -> Result

impl Default for LaunchOptions

fn default() -> Self

Auto Trait Implementations§

impl Freeze for LaunchOptions

impl RefUnwindSafe for LaunchOptions

impl Send for LaunchOptions

impl Sync for LaunchOptions

impl Unpin for LaunchOptions

impl UnsafeUnpin for LaunchOptions

impl UnwindSafe for LaunchOptions

Blanket Implementations§

impl<T> Any for Twhere T: 'static + ?Sized,

fn type_id(&self) -> TypeId

impl<T> Borrow<T> for Twhere T: ?Sized,

fn borrow(&self) -> &T

impl<T> BorrowMut<T> for Twhere T: ?Sized,

fn borrow_mut(&mut self) -> &mut T

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DTwhere ST: ?Sized, DT: ?Sized,

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DTwhere ST: ?Sized, DT: ?Sized,

impl<T> CloneToUninit for Twhere T: Clone,

unsafe fn clone_to_uninit(&self, dest: *mut u8)

impl<T> DynClone for Twhere T: Clone,

fn __clone_box(&self, _: Private) -> *mut ()

impl<T> ErasedDestructor for Twhere T: 'static,

impl<T> From<T> for T

fn from(t: T) -> T

impl<T> Instrument for T

fn instrument(self, span: Span) -> Instrumented<Self> ⓘ

fn in_current_span(self) -> Instrumented<Self> ⓘ

impl<T, U> Into<U> for Twhere U: From<T>,

fn into(self) -> U

impl<T> IntoEither for T

fn into_either(self, into_left: bool) -> Either<Self, Self> ⓘ

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘwhere F: FnOnce(&Self) -> bool,

impl<T> Pointable for T

const ALIGN: usize

type Init = T

unsafe fn init(init: <T as Pointable>::Init) -> usize

unsafe fn deref<'a>(ptr: usize) -> &'a T

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

unsafe fn drop(ptr: usize)

impl<T> PolicyExt for Twhere T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>where T: Sized + Policy<B, E>, P: Policy<B, E>,

fn or<P, B, E>(self, other: P) -> Or<T, P>where T: Sized + Policy<B, E>, P: Policy<B, E>,

impl<T> Read<Exclusive, BecauseExclusive> for Twhere T: ?Sized,

impl<T> Same for T

type Output = T

impl<T> ToOwned for Twhere T: Clone,

type Owned = T

fn to_owned(&self) -> T

fn clone_into(&self, target: &mut T)

impl<T, U> TryFrom<U> for Twhere U: Into<T>,

type Error = !

fn try_from(value: U) -> Result<T, !>

impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

type Error = <U as TryFrom<T>>::Error

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

impl<V, T> VZip<V> for Twhere V: MultiLane<T>,

fn vzip(self) -> V

impl<T> WithSubscriber for T

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘwhere S: Into<Dispatch>,

fn with_current_subscriber(self) -> WithDispatch<Self> ⓘ

Struct LaunchOptions

impl<T> Any for T
where T: 'static + ?Sized,

impl<T> Borrow<T> for T
where T: ?Sized,

impl<T> BorrowMut<T> for T
where T: ?Sized,

impl<ST, DT> CastableFrom<ST, Initialized, Initialized> for DT
where ST: ?Sized, DT: ?Sized,

impl<ST, DT> CastableFrom<ST, Uninit, Uninit> for DT
where ST: ?Sized, DT: ?Sized,

impl<T> CloneToUninit for T
where T: Clone,

impl<T> DynClone for T
where T: Clone,

impl<T> ErasedDestructor for T
where T: 'static,

impl<T, U> Into<U> for T
where U: From<T>,

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self> ⓘ
where F: FnOnce(&Self) -> bool,

impl<T> PolicyExt for T
where T: ?Sized,

fn and<P, B, E>(self, other: P) -> And<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

fn or<P, B, E>(self, other: P) -> Or<T, P>
where T: Sized + Policy<B, E>, P: Policy<B, E>,

impl<T> Read<Exclusive, BecauseExclusive> for T
where T: ?Sized,

impl<T> ToOwned for T
where T: Clone,

impl<T, U> TryFrom<U> for T
where U: Into<T>,

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

fn with_subscriber<S>(self, subscriber: S) -> WithDispatch<Self> ⓘ
where S: Into<Dispatch>,