Window.fullScreen — Eigenschaft · JavaScript-Referenz

Signatur

Window.fullScreen

Beschreibung

Die Eigenschaft window.fullScreen liefert true, wenn das Browserfenster im Vollbildmodus läuft, sonst false. Gemeint ist der Vollbildmodus des Fensters, z. B. nach Drücken von F11. Sie ist also nicht an ein bestimmtes Element gebunden.

Die Eigenschaft ist eine Firefox-eigene Erweiterung und gehört zu keinem Standard. In Chrome, Safari und Edge gibt es sie nicht, der Ausdruck ergibt dort undefined. Im Webinhalt kann man sie nur lesen. Schreiben (window.fullScreen = true) funktioniert nur mit erweiterten Rechten, etwa in Browser-Code oder in alten XUL-Erweiterungen. Auf normalen Webseiten hat das Schreiben keine Wirkung.

Wenn Sie Vollbild in Webanwendungen prüfen oder steuern wollen, nehmen Sie die standardisierte Fullscreen API: document.fullscreenElement, Element.requestFullscreen(), document.exitFullscreen() und das Ereignis fullscreenchange. window.fullScreen ist höchstens als ergänzende Prüfung sinnvoll, z. B. um in Firefox auch das per F11 ausgelöste Vollbild zu erkennen.

Rückgabewert

Typ

boolean | undefined

Beschreibung

true, wenn das Fenster im Vollbildmodus ist, sonst false. Browser ohne diese Eigenschaft liefern undefined (alle außer Firefox).

Beispiele

Vollbild-Zustand abfragen mit Funktionsprüfung

// Nur Firefox kennt window.fullScreen
if ('fullScreen' in window) {
  console.log(`Fenster im Vollbild: ${window.fullScreen}`);
} else {
  console.log('window.fullScreen wird nicht unterstützt');
}

Firefox: "Fenster im Vollbild: false" Andere Browser: "window.fullScreen wird nicht unterstützt"

Browserübergreifende Hilfsfunktion mit Fallback

const istVollbild = () => {
  // 1. Standard: ein Element per Fullscreen API im Vollbild?
  if (document.fullscreenElement) return true;
  // 2. Firefox: Fenster-Vollbild (z. B. per F11)
  if (typeof window.fullScreen === 'boolean') return window.fullScreen;
  // 3. Näherung: Viewport so groß wie der Bildschirm
  return window.innerHeight === screen.height && window.innerWidth === screen.width;
};

console.log(istVollbild());

false

Auf Wechsel des Vollbildmodus reagieren

// Es gibt kein eigenes Ereignis für window.fullScreen.
// Beim Wechsel in F11-Vollbild ändert sich aber die Fenstergröße.
const aktualisiereStatus = () => {
  const vollbild = document.fullscreenElement !== null || window.fullScreen === true;
  document.body.classList.toggle('ist-vollbild', vollbild);
  console.log('Vollbild:', vollbild);
};

window.addEventListener('resize', aktualisiereStatus);
document.addEventListener('fullscreenchange', aktualisiereStatus);
aktualisiereStatus();

Vollbild: false (nach F11 in Firefox) Vollbild: true

// Wichtig · Fallstricke

Nicht standardisiert: Die Eigenschaft gibt es nur in Firefox und sie steht in keiner Spezifikation. Verlassen Sie sich im Produktivcode nicht darauf. Prüfen Sie immer mit 'fullScreen' in window oder typeof window.fullScreen === 'boolean', ob sie vorhanden ist.
Nur lesbar für Webseiten: Die Zuweisung window.fullScreen = true hat im normalen Webinhalt keine Wirkung. Sie löst keinen Vollbildmodus aus und wirft auch keinen Fehler. Zum Umschalten nehmen Sie Element.requestFullscreen(). Dieser Aufruf braucht eine Nutzeraktion, z. B. einen Klick.
Schreibweise beachten: window.fullScreen hat ein großes S, die Standard-API dagegen nicht (document.fullscreenElement). Tippfehler führen still zu undefined.
Kein Änderungsereignis: Es gibt kein eigenes Ereignis für diese Eigenschaft. Beobachten Sie stattdessen resize oder bei der Fullscreen API fullscreenchange.
Größenvergleiche wie innerHeight === screen.height sind nur eine Näherung. Bei Zoom, Skalierung der Anzeige oder mehreren Bildschirmen können sie falsch liegen.

Siehe auch

Document.fullscreenElement Element.requestFullscreen() Document.exitFullscreen() Window ScreenDetails.currentScreen