Struct WebWindowState 

pub struct WebWindowState {
    pub inner_size: Extent<u32, 2>,
    pub outer_size: Extent<u32, 2>,
    pub screen_offset: Distance<i32, 2>,
    pub screen_size: Extent<u32, 2>,
    pub screen_usable_size: Extent<u32, 2>,
    pub dpr: f32,
    pub bpp: u8,
    /* private fields */
}

Available on crate feature web only.

▦ 🌐 Aggregates the live state of a WebWindow, including geometry and screen context.

---

^{📍 sys/os/browser/web}

---

It has a size of 52 Bytes.

Performance

All fields are fetched in a single JS→Rust call.

Fields

inner_size: Extent<u32, 2>

(innerWidth) (innerHeight) The extent in pixels of the content of the browser window including any rendered scrollbars.

outer_size: Extent<u32, 2>

(outerWidth) (outerHeight) The extent in pixels of the outside of the browser window.

screen_offset: Distance<i32, 2>

(screenLeft) (screenTop) The window’s offset in pixels from the screen’s top-left origin.

screen_size: Extent<u32, 2>

(width) (height) The extent of the screen in pixels.

screen_usable_size: Extent<u32, 2>

(availWidth) (availHeight) The extent of the screen in pixels, minus user interface features displayed.

dpr: f32

(devicePixelRatio) The device pixel ratio of the resolution in physical pixels to the resolution in CSS pixels.

The value changes with the zoom on desktops yet remains static on mobile devices.

bpp: u8

(colorDepth) The screen color depth, in bits per single pixel. It could be 8, 16, 24, 32 or 64.

Implementations

impl WebWindowState

pub fn new() -> WebWindowState

Available on crate feature unsafe_ffi only.

Returns a new up-to-date WebWindowState.

Safety

• JavaScript must write all non-padding fields at correct offsets.

pub fn update(&mut self)

Available on crate feature unsafe_ffi only.

Overwrites this WebWindowState with the latest live metrics.

pub const fn is_valid(&self) -> bool

Validates the internal consistency of window metrics.

Returns true if all these conditions hold:

• No dimensions are zero (invalid window state)
• Inner size ≤ outer size (logical constraint)
• Outer size ≤ screen size (unless multi-monitor)
• Device pixel ratio is sane (0.2 <= dpr <= 10.0)
• Screen color depth is plausible (8 <= depth <= 64)

pub const fn chrome_size(&self) -> Extent<u32, 2>

Returns the thickness of the window chrome (frame, scrollbars, etc.) in logical pixels.

This is the difference between the outer and inner window sizes.

pub const fn is_maximized(&self) -> bool

Checks if the window is approximately maximized (fills the available screen space).

Tolerance: The window must be within 1 pixel of the screen’s usable size.

pub const fn is_portrait(&self) -> bool

Checks if the window is in a portrait orientation (height > width).

pub const fn physical_size(&self) -> Extent<u32, 2>

Returns the physical size of the window in hardware pixels, truncating fractional values.

Computed as (inner_size * device_pixel_ratio).

For rounded values, use physical_size_rounded().

pub const fn physical_size_rounded(&self) -> Extent<u32, 2>

Returns the physical size of the window in hardware pixels, rounded to the nearest integer.

Computed as (inner_size * device_pixel_ratio).round().

It’s more accurate and expensive than physical_size().

pub const fn screen_margins(&self) -> [i32; 4]

Returns the window’s distance to each screen edge in logical pixels.

Order: [left, top, right, bottom]. Negative values mean the window is outside the screen.

Trait Implementations

impl Clone for WebWindowState

fn clone(&self) -> WebWindowState

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for WebWindowState

impl Debug for WebWindowState

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

Formats the value using the given formatter.

impl Default for WebWindowState

fn default() -> WebWindowState

Returns the “default value” for a type.

impl PartialEq for WebWindowState

fn eq(&self, other: &WebWindowState) -> 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 WebWindowState