W3cubDocs

/Web APIs

Document: hidden property

The Document.hidden read-only property returns a Boolean value indicating if the page is considered hidden or not.

Note: This property is described as "historical" in the Page Visibility Level 2 specification. Consider using the Document.visibilityState property instead.

Syntax

document.hidden

Examples

document.addEventListener("visibilitychange", () => {
  console.log(document.hidden);
  // Modify behavior…
});

Usage notes

Warning: Due to prerendering, it may happen that document.hidden is true, even if the page is actually visible to the user. In such scenario the page load starts with document.visibilityState = "prerender" and transitions to document.visibilityState = "visible" after some delay. This scenario can be reproduced by opening a new browser tab in Safari, pasting a URL in the URL bar, and navigating to that URL.

Specifications

Specification
HTML Standard # dom-document-hidden

Browser compatibility

	Desktop						Mobile
	Chrome	Edge	Firefox	Internet Explorer	Opera	Safari	WebView Android	Chrome Android	Firefox for Android	Opera Android	Safari on IOS	Samsung Internet
`hidden`	3313	12	18 Since Firefox 56 it also returns `true` on macOS when the window is completely hidden by another non-translucent application. 10–52	10	12.1	7	≤374.4.3	3318	18 Since Firefox 56 it also returns `true` on macOS when the window is completely hidden by another non-translucent application. 10–52	12.1	7	2.01.0

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/API/Document/hidden