Dokument: hasFocus()-Methode

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

Die hasFocus()-Methode des Document-Interfaces gibt einen booleschen Wert zurück, der anzeigt, ob das Dokument oder ein beliebiges Element im Dokument den Fokus hat. Diese Methode kann verwendet werden, um festzustellen, ob das aktive Element in einem Dokument den Fokus hat.

Hinweis: Beim Betrachten eines Dokuments ist ein Element mit Fokus immer das aktive Element im Dokument, aber ein aktives Element hat nicht notwendigerweise den Fokus. Zum Beispiel hat ein aktives Element innerhalb eines Popup-Fensters, das nicht im Vordergrund ist, keinen Fokus.

Syntax

js
hasFocus()

Parameter

Keine.

Rückgabewert

false, wenn das aktive Element im Dokument keinen Fokus hat; true, wenn das aktive Element im Dokument Fokus hat.

Beispiele

Überprüfung, ob das Dokument Fokus hat

Das folgende Beispiel überprüft, ob das Dokument Fokus hat oder nicht. Eine Funktion namens checkPageFocus() aktualisiert ein Absatz-Element je nach Ergebnis von document.hasFocus(). Das Öffnen eines neuen Fensters führt dazu, dass das Dokument den Fokus verliert, und das Zurückwechseln zum ursprünglichen Fenster führt dazu, dass das Dokument den Fokus wiedererlangt.

html
<p id="log">Focus check results are shown here.</p>
<button id="newWindow">Open new window</button>
js
const body = document.querySelector("body");
const log = document.getElementById("log");

function checkDocumentFocus() {
  if (document.hasFocus()) {
    log.textContent = "This document has focus.";
    body.style.background = "white";
  } else {
    log.textContent = "This document does not have focus.";
    body.style.background = "gray";
  }
}

function openWindow() {
  window.open(
    "https://developer.mozilla.org/",
    "MDN",
    "width=640,height=320,left=150,top=150",
  );
}

document.getElementById("newWindow").addEventListener("click", openWindow);
setInterval(checkDocumentFocus, 300);

Spezifikationen

Specification
HTML
# dom-document-hasfocus-dev

Browser-Kompatibilität

Report problems with this compatibility data on GitHub
desktopmobile
Chrome
Edge
Firefox
Opera
Safari
Chrome Android
Firefox for Android
Opera Android
Safari on iOS
Samsung Internet
WebView Android
WebView on iOS
hasFocus

Legend

Tip: you can click/tap on a cell for more information.

Full support
Full support
Partial support
Partial support
Has more compatibility info.

Siehe auch