WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / JavaScript

HTMLSelectElement.value — Wert der ausgewählten Option

HTMLSelectElement.value liest den Wert der ersten ausgewählten Option aus oder ändert die Auswahl, indem es eine Option anhand ihres Werts findet.

Version: ECMAScript and Web APIs; exact feature edition and browser support reviewed per entry; Node 24 in repository does not prove browser API support

Syntax

select.value
select.value = "value"

HTMLSelectElement.value gibt eine Zeichenfolge zurück: den Wert der ersten ausgewählten Option in der Reihenfolge des Baums oder "", wenn keine Option ausgewählt ist. Der Wert einer Option stammt aus ihrem value-Attribut oder, wenn dieses fehlt, aus ihrem Text.

Durch eine Zuweisung wird nur die erste Option ausgewählt, deren Wert übereinstimmt; die übrigen werden abgewählt, auch bei multiple. Gibt es keine Übereinstimmung, wird die Auswahl aufgehoben: value wird zu "" und selectedIndex zu -1.

Bei multiple liefert das Auslesen weiterhin einen einzelnen Wert und kein Array; selectedOptions gibt Zugriff auf alle ausgewählten Optionen. Anhand von "" allein lässt sich nicht unterscheiden, ob keine Option ausgewählt ist oder eine ausgewählte Option einen leeren Wert hat.

Beispiele

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);

Ergebnis

"b"
""
-1

Der angezeigte Code und das angegebene Ergebnis wurden in einer isolierten Umgebung mit der im Prüfnachweis für genau diese Version dokumentierten Methode verifiziert.

Quellen