73 lines
2.7 KiB
TypeScript
73 lines
2.7 KiB
TypeScript
|
type PseudoElement = '::before' | '::after';
|
||
|
|
/**
|
||
|
|
*
|
||
|
|
* 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.
|
||
|
|
*
|
||
|
|
* :::
|
||
|
|
*
|
||
|
|
* <example>
|
||
|
|
: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
|
||
|
|
// }
|
||
|
|
// }
|
||
|
|
})
|
||
|
|
* </example>
|
||
|
|
* @alias element.getCSSProperty
|
||
|
|
* @param {string} cssProperty css property name
|
||
|
|
* @param {PseudoElement} pseudoElement css pseudo element
|
||
|
|
* @return {CSSProperty} The specified css of the element
|
||
|
|
*
|
||
|
|
*/
|
||
|
|
export declare function getCSSProperty(this: WebdriverIO.Element, cssProperty: string, pseudoElement?: PseudoElement): Promise<import("../../types.js").ParsedCSSValue>;
|
||
|
|
export {};
|
||
|
|
//# sourceMappingURL=getCSSProperty.d.ts.map
|