CSSStyleDeclaration: getPropertyPriority() 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.

We’d love to hear your thoughts on the next set of proposals for the JavaScript language. You can find a description of the proposals here.
Please take two minutes to fill out our short survey.

The CSSStyleDeclaration.getPropertyPriority() method interface returns a string that provides all explicitly set priorities on the CSS property.

Syntax

js
getPropertyPriority(property)

Parameters

property

A string representing the property name to be checked.

Return value

A string that represents the priority (e.g., "important") if one exists. If none exists, returns the empty string.

Examples

The following JavaScript code checks whether margin is marked as important in a CSS selector rule:

js
const declaration = document.styleSheets[0].cssRules[0].style;
const isImportant = declaration.getPropertyPriority("margin") === "important";

Specifications

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

Browser compatibility