The read-only innerHeight
property of the Window
interface returns the interior height of the window in pixels, including the height of the horizontal scroll bar, if present.
The value of innerHeight
is taken from the height of the window's layout viewport. The width can be obtained using the innerWidth
property.
Syntax
let intViewportHeight = window.innerHeight;
Value
An integer value indicating the window's layout viewport height in pixels. The property is read only and has no default value.
To change the width of the window, call one of its resize methods, such as resizeTo()
or resizeBy()
.
Usage notes
To obtain the height of the window minus its horizontal scroll bar and any borders, use the root <html>
element's clientHeight()
property instead.
Both innerHeight
and innerWidth
are available on any window or any object that behaves like a window, such as a tab or frame.
Example
Assuming a frameset
var intFrameHeight = window.innerHeight; // or var intFrameHeight = self.innerHeight; // will return the height of the frame viewport within the frameset var intFramesetHeight = parent.innerHeight; // will return the height of the viewport of the closest frameset var intOuterFramesetHeight = top.innerHeight; // will return the height of the viewport of the outermost frameset
FIXME: link to an interactive demo here
To change the size of a window, see window.resizeBy()
and window.resizeTo()
.
To get the outer height of a window, i.e. the height of the whole browser window, see window.outerHeight
.
Graphical example
The following figure shows the difference between outerHeight
and innerHeight
.
[[File:../../../../../../media.prod.mdn.mozit.cloud/attachments/2012/07/09/443/adfceb7859dded4586607785d63f6bbc/FirefoxInnerVsOuterHeight2.png|innerHeight vs outerHeight illustration]]
Specification
Specification | Status | Comment |
---|---|---|
CSS Object Model (CSSOM) View ModuleThe definition of 'window.innerHeight' in that specification. | Working Draft | Initial definition |
Browser compatibility
The compatibility table on this page is generated from structured data. If you'd like to contribute to the data, please check out https://github.com/mdn/browser-compat-data and send us a pull request.
Update compatibility data on GitHub
Desktop | Mobile | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
innerHeight
|
Chrome
Full support 1 |
Edge
Full support 12 |
Firefox Full support 1 Full support 1 No support 4 — 24 Notes' This property was buggy and could give a wrong value before page load in certain circumstances, see bug 641188. |
IE
Full support 9 |
Opera
Full support 9 |
Safari
Full support 3 |
WebView Android
Full support 1 |
Chrome Android
Full support 18 |
Firefox Android Full support 4 Full support 4 No support 4 — 24 Notes' This property was buggy and could give a wrong value before page load in certain circumstances, see bug 641188. |
Opera Android
Full support 10.1 |
Safari iOS Full support 1 Full support 1 Notes' This property returns the height of the visual viewport instead of the layout viewport. See this bug for details. |
Samsung Internet Android
Full support 1.0 |
Legend
- Full support
- Full support
- See implementation notes.'
- See implementation notes.
See also
Window.innerHeight by Mozilla Contributors is licensed under CC-BY-SA 2.5.