Navigator: windowControlsOverlay property

Secure context

The windowControlsOverlay read-only property of the Navigator interface returns the WindowControlsOverlay interface, which exposes information about the title bar geometry in desktop Progressive Web Apps that use the Window Controls Overlay API.

Progressive Web Apps installed on desktop Operating Systems can opt-in to the Window Controls Overlay feature by using the window-controls-overlay value in the display_override web app manifest member.

Doing so hides the default window title bar and gives the app access to the full area of the app window.

Value

The WindowControlsOverlay interface.

Examples

if ("windowControlsOverlay" in navigator) {
  const rect = navigator.windowControlsOverlay.getTitlebarAreaRect();
  // Do something with the title bar area rectangle.
} else {
  // The Window Controls Overlay feature is not available.
}

Specifications

Browser compatibility