CSSPrimitiveValue: getStringValue()-Methode

Veraltet: Diese Funktion wird nicht mehr empfohlen. Obwohl einige Browser sie möglicherweise noch unterstützen, kann sie bereits aus den relevanten Webstandards entfernt worden sein, befindet sich im Prozess der Entfernung oder wird nur aus Kompatibilitätsgründen beibehalten. Vermeiden Sie die Verwendung und aktualisieren Sie gegebenenfalls bestehenden Code; siehe die Kompatibilitätstabelle am Ende dieser Seite, um Ihre Entscheidung zu treffen. Beachten Sie, dass diese Funktion jederzeit nicht mehr funktionieren kann.

Die getStringValue()-Methode der CSSPrimitiveValue-Schnittstelle wird verwendet, um einen Zeichenkettenwert abzurufen. Falls dieser CSS-Wert keinen Zeichenkettenwert enthält, wird eine DOMException ausgelöst.

Hinweis: Diese Methode war Teil eines Versuchs, ein typisiertes CSS-Objektmodell zu erstellen. Dieser Versuch wurde aufgegeben, und die meisten Browser implementieren es nicht.

Um Ihr Ziel zu erreichen, können Sie verwenden:

Syntax

js
getStringValue()

Parameter

Keine.

Rückgabewert

Ein string-Wert.

Ausnahmen

Typ Beschreibung
DOMException Ein INVALID_ACCESS_ERR wird ausgelöst, wenn der CSS-Wert keinen Zeichenkettenwert enthält.

Beispiele

js
const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("display");
console.log(cssValue.getStringValue());

Spezifikationen

Dieses Feature wurde ursprünglich in der DOM Style Level 2-Spezifikation definiert, ist jedoch seitdem aus jeglichen Standardisierungsbemühungen entfernt worden.

Es wurde durch ein modernes, aber inkompatibles CSS Typed Object Model API ersetzt, das sich nun auf dem Standardweg befindet.

Browser-Kompatibilität

BCD tables only load in the browser