---
title: document.hasFocus
slug: Web/API/Document/hasFocus
tags:
- API
- DOM
- Focus
- Méthodes
- Reference
translation_of: Web/API/Document/hasFocus
---
{{ ApiRef() }}
La méthode **`Document.hasFocus()`** retourne une valeur {{jsxref("Boolean")}} `true` _(vrai)_ indiquant si le document ou tout élément à l'intérieur du document a le focus. Cette méthode peut être utilisée pour déterminer si l'élément actif d'un document a le focus.
> **Note :** Lors de la visualisation d'un document, un élément avec focus est toujours l'élément actif dans le document, mais un élément actif n'a pas nécessairement le focus. Par exemple, un élément actif dans une fenêtre contextuelle qui n'est pas le premier plan n'a pas de focus.
## Syntaxe
focused = document.hasFocus();
### Valeur retournée
`false` _(faux)_ si l'élément actif dans le document n'a pas de focus ; `true` _(vrai)_ si l'élément actif dans le document a le focus.
## Exemple
```html
TEST
JavaScript hasFocus example
Waiting for user action
```
## Spécification
| Spécification | Statut | Commentaire |
| ---------------------------------------------------------------------------------------------------------------------------- | -------------------------------- | ------------------- |
| {{SpecName('HTML WHATWG', 'interaction.html#dom-document-hasfocus', 'Document.hasFocus()')}} | {{Spec2('HTML WHATWG')}} | Définition initiale |
## Compatibilité des navigateurs
{{Compat("api.Document.hasFocus")}}
## Voir aussi
- [Utilisation de l'API de visibilité des pages](/fr/docs/Web/API/Page_Visibility_API)