CSSUnitValue: CSSUnitValue() constructor

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

See full compatibility

The CSSUnitValue() constructor creates a new CSSUnitValue object which returns a new CSSUnitValue object which represents values that contain a single unit type. For example, "42px" would be represented by a CSSNumericValue.

Syntax

new CSSUnitValue(value, unit)

Parameters

value: A double indicating the number of units.
unit: A string indicating the type of unit.

Examples

The following shows a method of creating a CSSPositionValue from individual CSSUnitValue constructors.

let pos = new CSSPositionValue(
  new CSSUnitValue(5, "px"),
  new CSSUnitValue(10, "px"),
);

Specifications

Specification
CSS Typed OM Level 1 # dom-cssunitvalue-cssunitvalue

Browser compatibility

	desktop					mobile
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox for Android	Opera Android	Safari on iOS	Samsung Internet	WebView Android	WebView on iOS
`CSSUnitValue()` constructor	Chrome – Full support Chrome 66 (Release date: 2018-04-17) footnote Full support	Edge – Full support Edge 79 (Release date: 2020-01-15) footnote Full support	Firefox – No support Firefox footnote footnote See bug 1278697	Opera – Full support Opera 53 (Release date: 2018-05-10) footnote Full support	Safari – Full support Safari 16.4 (Release date: 2023-03-27) footnote Full support	Chrome Android – Full support Chrome Android 66 (Release date: 2018-04-17) footnote Full support	Firefox for Android – No support Firefox for Android footnote footnote See bug 1278697	Opera Android – Full support Opera Android 47 (Release date: 2018-07-23) footnote Full support	Safari on iOS – Full support Safari on iOS 16.4 (Release date: 2023-03-27) footnote Full support	Samsung Internet – Full support Samsung Internet 9 (Release date: 2018-09-15) footnote Full support	WebView Android – Full support WebView Android 66 (Release date: 2018-04-17) footnote Full support	WebView on iOS – Full support WebView on iOS 16.4 (Release date: 2023-03-27) footnote Full support

Tip: you can click/tap on a cell for more information.

Full support: Full support
No support: No support
: See implementation notes.