Struct Target 

pub struct Target {
    pub url: String,
    pub viewport: ViewportKey,
    pub width: u32,
    pub height: u32,
    pub device_pixel_ratio: f32,
    pub wait_for_selector: Option<String>,
    pub wait_ms: Option<u64>,
    pub disable_animations: bool,
    pub hide_scrollbars: bool,
    pub pin_dpr: Option<f64>,
}

A snapshot target: URL + viewport + per-target capture knobs.

The capture knobs (wait_for_selector, wait_ms, disable_animations, hide_scrollbars, pin_dpr) are documented in PRD §15. They control browser-side behavior between navigation and DOMSnapshot.captureSnapshot and never flow into snapshot content — they only affect when the snapshot is captured and what CSS state the page is in at that moment.

Fields

url: String

URL to navigate to. The plumb-fake:// scheme is reserved for deterministic fixtures used by tests and the walking-skeleton CLI.

viewport: ViewportKey

Named viewport.

width: u32

Viewport width in CSS pixels.

height: u32

Viewport height in CSS pixels.

device_pixel_ratio: f32

Device pixel ratio.

wait_for_selector: Option<String>

Optional CSS selector to wait for before capturing the snapshot. When set, the driver polls the page until at least one matching element exists. Compatible with Self::wait_ms — both fire, in order: selector first, then the additional sleep.

wait_ms: Option<u64>

Optional additional milliseconds to sleep before capturing the snapshot, after navigation (and after Self::wait_for_selector).

disable_animations: bool

Inject CSS that disables animations and transitions before the page renders. Defaults to true — the historical Plumb behavior (PRD §16) — and the CLI exposes a flag that flips this value.

hide_scrollbars: bool

Inject CSS that hides page-level scrollbars. Defaults to true to match the Chromium launch arg --hide-scrollbars. The CSS belt-and-suspenders covers cases where the launch arg alone is not honored (e.g. older Chromium majors on certain platforms).

pin_dpr: Option<f64>

Optional explicit device-pixel ratio override applied via Emulation.setDeviceMetricsOverride.deviceScaleFactor instead of using Self::device_pixel_ratio. When None, the existing device_pixel_ratio is used. The CLI exposes this as --dpr.

Implementations

impl Target

pub fn effective_dpr(&self) -> f64

Effective device-scale factor for Emulation.setDeviceMetricsOverride.

Prefers Self::pin_dpr when set, otherwise falls back to Self::device_pixel_ratio. Centralizing the choice keeps the “pin overrides default” rule in one place.

Trait Implementations

impl Clone for Target

fn clone(&self) -> Target

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Target

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

Formats the value using the given formatter.

impl Default for Target

fn default() -> Self

Returns the “default value” for a type.

impl PartialEq for Target

fn eq(&self, other: &Target) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for Target