This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The get() method of the StylePropertyMapReadOnly interface returns a CSSStyleValue object for the first value of the specified property.


var declarationBlock = StylePropertyMapReadOnly.get(property)


The name of the property to retrieve the value of.

Return value

A CSSStyleValue object.


Let's get just a few properties and values. Let's start by creating a link inside a paragraph in our HTML, and adding a definition list which we will populate with JavaScript:

   <a href="">Link</a>
<dl id="results"></dl>

We add a bit of CSS, including a custom property and an inheritable property:

p {
  font-weight: bold;
a {
   --color: red;
   color: var(--color);

We use the Element's computedStyleMap() to return a StylePropertyMapReadOnly object. We create an array of properties of interest and use the StylePropertyMapReadOnly's get() method to get only those values.

// get the element
const myElement = document.querySelector('a');

// Retrieve all computed styles with computedStyleMap()
const styleMap = myElement.computedStyleMap();

// get the <dl> we'll be populating
const stylesList = document.querySelector('#results');

// array of properties we're interested in
const ofInterest = ['font-weight', 'border-left-color', 'color', '--color'];

// iterate over our properties of interest
for ( let i = 0; i < ofInterest.length; i++ ) {

  // properties
  const cssProperty = document.createElement('dt');
  cssProperty.innerText = ofInterest[i];

  // values
  const cssValue = document.createElement('dd');
  // use get() to find the value
  cssValue.innerText = styleMap.get(ofInterest[i]);


Specification Status Comment
CSS Typed OM Level 1
The definition of 'get()' in that specification.
Working Draft Initial definition.

Browser compatibility

BCD tables only load in the browser

See also