CKTIS / JavaScript
HTMLSelectElement.value — valeur de l’option sélectionnée
HTMLSelectElement.value lit la valeur de la première option sélectionnée ou modifie la sélection en recherchant une option ayant une valeur donnée.
Version : ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support
Syntaxe
select.value
select.value = "value"HTMLSelectElement.value renvoie une chaîne de caractères : la valeur de la première option sélectionnée dans l’ordre de l’arbre, ou "" si aucune option n’est sélectionnée. La valeur d’une option provient de son attribut value ou, si cet attribut est absent, de son texte.
Une affectation sélectionne uniquement la première option correspondante et désélectionne les autres, même avec multiple. En l’absence de correspondance, la sélection est effacée : value devient "" et selectedIndex devient -1.
Avec multiple, la lecture renvoie toujours une seule valeur, et non un tableau ; selectedOptions donne accès à toutes les options sélectionnées. La valeur "" ne permet pas, à elle seule, de distinguer l’absence de sélection d’une option sélectionnée dont la valeur est vide.
Exemples
const select = document.createElement("select");
select.add(new Option("Alpha", "a"));
select.add(new Option("Beta", "b"));
select.value = "b";
console.log(JSON.stringify(select.value));
select.value = "missing";
console.log(JSON.stringify(select.value));
console.log(select.selectedIndex);Résultat
"b" "" -1
Le code affiché et le résultat déclaré ont été vérifiés dans un environnement isolé selon la méthode consignée dans la preuve de vérification de cette version exacte.