Window : méthode close()
Baseline
Widely available
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis juillet 2015.
La méthode close() de l'interface Window ferme la fenêtre courante ou celle sur laquelle elle a été appelée.
Les fenêtres sont fermables par script si elles ont été créées par du contenu web. Cela inclut généralement :
- Fenêtres ouvertes avec
Window.open(). - Fenêtres ouvertes via du contenu web, comme des liens (
<a target="_blank">) ou des formulaires (<form target="_blank">), sans action de modification de l'utilisateur·ice.
Les fenêtres ouvertes par des actions de l'interface du navigateur — comme clic droit → Ouvrir dans un nouvel onglet, Ctrl + clic, Maj + clic ou clic du milieu — ne sont souvent pas fermables par script. Elles ne peuvent être fermées que si elles n'ont pas été naviguées (la longueur de l'historique reste 1). Appeler close() dans d'autres cas affiche généralement un avertissement dans la console : Scripts may not close windows that were not opened by script.
Notez également que close() n'a aucun effet lorsqu'elle est appelée sur des objets Window retournés par HTMLIFrameElement.contentWindow.
Syntaxe
close()
Paramètres
Aucun.
Valeur de retour
Aucune (undefined).
Exemples
Fermeture d'une fenêtre ouverte avec window.open()
Cet exemple montre une méthode qui ouvre une fenêtre et une seconde qui la ferme ; cela montre comment utiliser Window.close() pour fermer une fenêtre ouverte par un appel à window.open().
// Global variable to store a reference to the opened window
let openedWindow;
function openWindow() {
openedWindow = window.open("more-info.htm");
}
function closeOpenedWindow() {
openedWindow.close();
}
Spécifications
| Specification |
|---|
| HTML # dom-window-close-dev |