# getCSSProperty

Get a css property from a DOM-element selected by given selector. The return value is formatted to be testable. Colors gets parsed via [rgb2hex](https://www.npmjs.org/package/rgb2hex) and all other properties get parsed via [css-value](https://www.npmjs.org/package/css-value).

info

Note that shorthand CSS properties (e.g. `background`, `font`, `border`, `margin`, `padding`, `list-style`, `outline`, `pause`, `cue`) will be expanded to fetch all longhand properties resulting in multiple WebDriver calls. If you are interested in a specific longhand property it is recommended to query for that instead.

## Usage[​](#usage "Direct link to Usage")

```
await $(selector).getCSSProperty(cssProperty, pseudoElement)
```

## Parameters[​](#parameters "Direct link to Parameters")

| Name            | Type            | Details            |
| --------------- | --------------- | ------------------ |
| `cssProperty`   | `string`        | css property name  |
| `pseudoElement` | `PseudoElement` | css pseudo element |

## Examples[​](#examples "Direct link to Examples")

example.html

```
<label id="myLabel" for="input" style="color: #0088cc; font-family: helvetica, arial, freesans, clean, sans-serif, width: 100px">Some Label</label>
```

getCSSProperty.js

```
it('should demonstrate the getCSSProperty command', async () => {

    const elem = await $('#myLabel')

    const color = await elem.getCSSProperty('color')

    console.log(color)

    // outputs the following:

    // {

    //     property: 'color',

    //     value: 'rgba(0, 136, 204, 1)',

    //     parsed: {

    //         hex: '#0088cc',

    //         alpha: 1,

    //         type: 'color',

    //         rgba: 'rgba(0, 136, 204, 1)'

    //     }

    // }



    const font = await elem.getCSSProperty('font-family')

    console.log(font)

    // outputs the following:

    // {

    //      property: 'font-family',

    //      value: 'helvetica',

    //      parsed: {

    //          value: [ 'helvetica', 'arial', 'freesans', 'clean', 'sans-serif' ],

    //          type: 'font',

    //          string: 'helvetica, arial, freesans, clean, sans-serif'

    //      }

    // }



    var width = await elem.getCSSProperty('width', '::before')

    console.log(width)

    // outputs the following:

    // {

    //     property: 'width',

    //     value: '100px',

    //     parsed: {

    //         type: 'number',

    //         string: '100px',

    //         unit: 'px',

    //         value: 100

    //     }

    // }

})
```

## Returns[​](#returns "Direct link to Returns")

* **\<CSSProperty>** **`return`:** The specified css of the element
