CSSStyleDeclaration: getPropertyValue() method

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2015.

The CSSStyleDeclaration.getPropertyValue() method interface returns a string containing the value of a specified CSS property.

Syntax

js
getPropertyValue(property)

Parameters

property

A string representing the property name (in hyphen case) to be checked.

Return value

A string containing the value of the property. If not set, returns the empty string.

Examples

The following JavaScript code queries the value of the margin property in a CSS selector rule:

js
const declaration = document.styleSheets[0].cssRules[0].style;
const value = declaration.getPropertyValue("margin"); // "1px 2px"

Specifications

Specification
CSS Object Model (CSSOM)
# dom-cssstyledeclaration-getpropertyvalue

Browser compatibility

BCD tables only load in the browser