CSSStyleDeclaration: removeProperty() 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.removeProperty() method interface removes a property from a CSS style declaration object.

Syntax

js
removeProperty(property)

Parameters

property

A string representing the property name to be removed. Multi-word property names are hyphenated (kebab-case) and not camel-cased.

Return value

A string equal to the value of the CSS property before it was removed.

Exceptions

NoModificationAllowedError DOMException

Thrown when the property or declaration block is read-only.

Examples

The following JavaScript code removes the background-color CSS property from a selector rule:

js
const declaration = document.styleSheets[0].rules[0].style;
const oldValue = declaration.removeProperty("background-color");

Specifications

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

Browser compatibility

BCD tables only load in the browser