Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources