Firefox Tomorrow

web api instance property

CSSPrimitiveValue: primitiveType property

View on MDN ↗

The primitiveType read-only property of the CSSPrimitiveValue interface represents the type of a CSS value.

[!NOTE] This property was part of an attempt to create a typed CSS Object Model. This attempt has been abandoned, and most browsers do not implement it.

To achieve your purpose, you can use:

Value

An unsigned short representing the type of the value. Possible values are:

Constant Description
CSS_ATTR The value is an [`attr()`](/firefox/mdn/css/reference/values/attr/) function. The value can be obtained by using the getStringValue() method.
CSS_CM The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in centimeters. The value can be obtained by using the getFloatValue() method.
CSS_COUNTER The value is a counter or counters function. The value can be obtained by using the getCounterValue() method.
CSS_DEG The value is an [`<angle>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<angle>) in degrees. The value can be obtained by using the getFloatValue() method.
CSS_DIMENSION The value is a [`<number>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<number>) with an unknown dimension. The value can be obtained by using the getFloatValue() method.
CSS_EMS The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in em units. The value can be obtained by using the getFloatValue() method.
CSS_EXS The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in ex units. The value can be obtained by using the getFloatValue() method.
CSS_GRAD The value is an [`<angle>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<angle>) in grads. The value can be obtained by using the getFloatValue() method.
CSS_HZ The value is a [`<frequency>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<frequency>) in Hertz. The value can be obtained by using the getFloatValue method.
CSS_IDENT The value is an identifier. The value can be obtained by using the getStringValue() method.
CSS_IN The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in inches. The value can be obtained by using the getFloatValue() method.
CSS_KHZ The value is a [`<frequency>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<frequency>) in Kilohertz. The value can be obtained by using the getFloatValue() method.
CSS_MM The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in millimeters. The value can be obtained by using the getFloatValue() method.
CSS_MS The value is a [`<time>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<time>) in milliseconds. The value can be obtained by using the getFloatValue() method.
CSS_NUMBER The value is a simple [`<number>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<number>). The value can be obtained by using the getFloatValue() method.
CSS_PC The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in picas. The value can be obtained by using the getFloatValue() method.
CSS_PERCENTAGE The value is a [`<percentage>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<percentage>). The value can be obtained by using the getFloatValue() method.
CSS_PT The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in points. The value can be obtained by using the getFloatValue() method.
CSS_PX The value is a [`<length>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<length>) in pixels. The value can be obtained by using the getFloatValue() method.
CSS_RAD The value is an [`<angle>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<angle>) in radians. The value can be obtained by using the getFloatValue() method.
CSS_RECT The value is a [`rect()`](/firefox/mdn/css/reference/values/shape/) function. The value can be obtained by using the getRectValue() method.
CSS_RGBCOLOR The value is an [`<color>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<color>). The value can be obtained by using the getRGBColorValue() method.
CSS_S The value is a [`<time>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<time>) in seconds. The value can be obtained by using the getFloatValue() method.
CSS_STRING The value is a [`<string>`](https://developer.mozilla.org/en-US/docs/Web/CSS/<string>). The value can be obtained by using the getStringValue() method.
CSS_UNKNOWN The value is not a recognized CSS2 value. The value can only be obtained by using the [`cssText`](/firefox/mdn/api/cssvalue/csstext/) attribute.
CSS_URI The value is a [`<url>`](/firefox/mdn/css/reference/values/url_value/). The value can be obtained by using the getStringValue() method.

Examples

const cs = window.getComputedStyle(document.body);
const cssValue = cs.getPropertyCSSValue("color");
console.log(cssValue.primitiveType);

Specifications

This feature was originally defined in the DOM Style Level 2 specification, but has been dropped from any standardization effort since then.

It has been superseded by a modern, but incompatible, CSS Typed Object Model API that is now on the standard track.

Browser compatibility

Browser compatibilityCompatibility data is available on the canonical MDN page.

See also