Window : méthode alert()
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 alert() de l'interface Window indique au navigateur d'afficher une boîte de dialogue avec un message optionnel, et d'attendre que la personne ferme cette boîte de dialogue.
Dans certaines conditions — par exemple, lorsque l'utilisateur·ice change d'onglet — le navigateur peut ne pas afficher réellement une boîte de dialogue, ou peut ne pas attendre que l'utilisateur·ice ferme la boîte.
Syntaxe
alert()
alert(message)
Paramètres
messageFacultatif-
Une chaîne de caractères qu'on souhaite afficher dans la boîte de dialogue. Si la valeur fournie est un objet, elle sera convertie en chaîne de caractères puis affichée.
Valeur de retour
Aucune (undefined).
Exemples
window.alert("Bonjour le monde !");
alert("Bonjour le monde !");
produiront tous les deux ce qui suit :
Notes
La boîte de dialogue d'alerte doit être utilisée pour les messages qui ne nécessitent aucune réponse de la part de l'utilisateur·ice, autre que la reconnaissance du message.
Les boîtes de dialogue sont des fenêtres qui bloquent l'accès — elles empêchent l'utilisateur·ice d'accéder au reste de l'interface du programme tant que la boîte de dialogue n'est pas fermée. Pour cette raison, il ne faut pas abuser des fonctions qui créent une boîte de dialogue (ou une fenêtre qui bloque l'accès).
L'élément HTML <dialog> peut également être utilisé pour afficher des alertes.
Spécifications
| Specification |
|---|
| HTML # dom-alert-dev |