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.

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

BCD tables only load in the browser