CSSStyleDeclaration.removeProperty()

The CSSStyleDeclaration.removeProperty() method interface removes a property from a CSS style declaration object.

Syntax

var oldValue = style.removeProperty(property);

Parameters

  • property is a DOMString representing the property name to be removed. Note that multi-word property names are hyphenated and not camel-cased.

Return value

  • oldValue is a DOMString equal to the value of the CSS property before it was removed.

Exceptions

  • DOMException NO_MODIFICATION_ALLOWED_ERR: if the property or declaration block is read only.

Example

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

var declaration = document.styleSheets[0].rules[0].style;
var oldValue = declaration.removeProperty('background-color');

Specifications

Specification Status Comment
CSS Object Model (CSSOM)
The definition of 'CSSStyleDeclaration.removeProperty()' in that specification.
Working Draft
Document Object Model (DOM) Level 2 Style Specification
The definition of 'CSSStyleDeclaration' in that specification.
Obsolete

Browser compatibility

DesktopMobile
ChromeEdgeFirefoxInternet ExplorerOperaSafariAndroid webviewChrome for AndroidFirefox for AndroidOpera for AndroidSafari on iOSSamsung Internet
removePropertyChrome Full support 1Edge Full support 12Firefox Full support 1IE Full support YesOpera Full support YesSafari Full support 6WebView Android Full support 4.4Chrome Android Full support 18Firefox Android Full support 4Opera Android Full support YesSafari iOS Full support YesSamsung Internet Android Full support 1.0

Legend

Full support
Full support