Document: visibilityState プロパティ

Document.visibilityState は読み取り専用プロパティで、この文書の可視性を返します。文書がバックグラウンドにあるか、最小化されたウィンドウにあるか、あるいはユーザーから見えないかどうかを調べるために使用することができます。

このプロパティを変更すると、visibilitychange イベントが Document へ送られます。

Document.hidden プロパティは、ページが非表示かどうかを判断する別の方法を提供します。

値

利用可能な値は次のとおりです。

visible

ページのコンテンツは、少なくとも部分的に表示される場合があります。実際には、これはページが最小化されていないウィンドウのフォアグラウンドタブであることを意味します。

hidden

ページのコンテンツはユーザーには表示されません。実際には、これは文書がバックグラウンドタブまたは最小化されたウィンドウの一部であるか、 OS の画面ロックがアクティブであることを意味します。

例

js
document.addEventListener("visibilitychange", () => {
  console.log(document.visibilityState);
  // 振る舞いを変更します...
});

仕様書

Specification
HTML Standard
# dom-document-visibilitystate

ブラウザーの互換性

BCD tables only load in the browser

関連情報