Document.hidden

Document.hidden は読み取り専用のプロパティで、ページが非表示になっているとみられるかどうかを示す論理値を返します。

メモ: このプロパティは、Page Visibility Level 2 仕様書では「歴史的」と記述されています。代わりに Document.visibilityState プロパティを使用することを検討してください。

構文

js
document.hidden

js
document.addEventListener("visibilitychange", () => {
  console.log(document.hidden);
  // 振る舞いを修正...
});

使用上の注意

警告: プリレンダリングのために、ページがユーザーにとって実際に可視であっても、document.hidden が true になることがあります。このようなシナリオでは、ページの読み込みは document.visibilityState = "prerender" で始まり、ある程度遅れて document.visibilityState = "visible" に遷移します。このシナリオは、 Safari で新しいブラウザータブを開き、 URL バーに URL を貼り付けて、その URL へ移動することで再現することができます。

仕様書

Specification
HTML Standard
# dom-document-hidden

ブラウザーの互換性

BCD tables only load in the browser