2022-01-13 05:24:12 +00:00
import {
PropertyPaneConfig ,
PropertyPaneControlConfig ,
ValidationConfig ,
} from "constants/PropertyControlConstants" ;
import { ValidationTypes } from "constants/WidgetValidation" ;
2022-06-23 15:09:00 +00:00
import WidgetFactory from "utils/WidgetFactory" ;
import { ALL_WIDGETS_AND_CONFIG , registerWidgets } from "./WidgetRegistry" ;
2022-01-13 05:24:12 +00:00
function validatePropertyPaneConfig ( config : PropertyPaneConfig [ ] ) {
for ( const sectionOrControlConfig of config ) {
if ( sectionOrControlConfig . children ) {
for ( const propertyControlConfig of sectionOrControlConfig . children ) {
const propertyControlValidation = validatePropertyControl (
propertyControlConfig ,
) ;
if ( propertyControlValidation !== true )
return propertyControlValidation ;
}
}
}
return true ;
}
function validatePropertyControl ( config : PropertyPaneConfig ) : boolean | string {
const _config = config as PropertyPaneControlConfig ;
const controls = [ "INPUT_TEXT" ] ;
if (
( _config . isJSConvertible || controls . includes ( _config . controlType ) ) &&
! _config . isTriggerProperty
) {
if ( ! _config . isBindProperty )
return ` ${
_config . propertyName
} : isBindProperty should be true if isJSConvertible is true or when control type is [ $ { controls . join (
" | " ,
) } ] ` ;
if ( ! _config . validation )
return ` ${
_config . propertyName
} : validation should be defined if isJSConvertible is true or when control type is [ $ { controls . join (
" | " ,
) } ] ` ;
}
if ( _config . validation !== undefined ) {
const res = validateValidationStructure ( _config . validation ) ;
if ( res !== true ) return ` ${ _config . propertyName } : ${ res } ` ;
}
if ( _config . children ) {
for ( const child of _config . children ) {
const res = validatePropertyControl ( child ) ;
if ( res !== true ) return ` ${ _config . propertyName } . ${ res } ` ;
}
}
if ( _config . panelConfig ) {
const res = validatePropertyPaneConfig ( _config . panelConfig . children ) ;
if ( res !== true ) return ` ${ _config . propertyName } . ${ res } ` ;
}
return true ;
}
function validateValidationStructure (
config : ValidationConfig ,
) : boolean | string {
if (
config . type === ValidationTypes . FUNCTION &&
config . params &&
config . params . fn
) {
if ( ! config . params . expected )
return ` For a ${ ValidationTypes . FUNCTION } type validation, expected type and example are mandatory ` ;
}
return true ;
}
2022-01-21 10:19:10 +00:00
const isNotFloat = ( n : any ) = > {
return Number ( n ) === n && n % 1 === 0 ;
} ;
2022-01-13 05:24:12 +00:00
describe ( "Tests all widget's propertyPane config" , ( ) = > {
2022-06-23 15:09:00 +00:00
beforeAll ( ( ) = > {
registerWidgets ( ) ;
} ) ;
2022-01-21 10:19:10 +00:00
ALL_WIDGETS_AND_CONFIG . forEach ( ( widgetAndConfig ) = > {
const [ widget , config ] : any = widgetAndConfig ;
2022-01-13 05:24:12 +00:00
it ( ` Checks ${ widget . getWidgetType ( ) } 's propertyPaneConfig ` , ( ) = > {
const propertyPaneConfig = widget . getPropertyPaneConfig ( ) ;
const validatedPropertyPaneConfig = validatePropertyPaneConfig (
propertyPaneConfig ,
) ;
expect ( validatedPropertyPaneConfig ) . toStrictEqual ( true ) ;
} ) ;
2022-01-21 10:19:10 +00:00
it ( ` Check if ${ widget . getWidgetType ( ) } 's dimensions are always integers ` , ( ) = > {
expect ( isNotFloat ( config . defaults . rows ) ) . toBe ( true ) ;
expect ( isNotFloat ( config . defaults . columns ) ) . toBe ( true ) ;
} ) ;
2022-06-23 15:09:00 +00:00
if ( config . isDeprecated && config . replacement !== undefined ) {
it ( ` Check if ${ widget . getWidgetType ( ) } 's deprecation config has a proper replacement Widget ` , ( ) = > {
const widgetType = widget . getWidgetType ( ) ;
const replacementWidgetType = config . replacement ;
const replacementWidgetConfig = WidgetFactory . widgetConfigMap . get (
replacementWidgetType ,
) ;
if ( replacementWidgetConfig === undefined ) {
fail (
` ${ widgetType } 's replacement widget ${ replacementWidgetType } does not resolve to an actual widget Config ` ,
) ;
}
if ( replacementWidgetConfig ? . isDeprecated ) {
fail (
` ${ widgetType } 's replacement widget ${ replacementWidgetType } itself is deprecated. Cannot have a deprecated widget as a replacement for another deprecated widget ` ,
) ;
}
if ( replacementWidgetConfig ? . hideCard ) {
fail (
` ${ widgetType } 's replacement widget ${ replacementWidgetType } should be available in the entity Explorer ` ,
) ;
}
} ) ;
}
2022-01-13 05:24:12 +00:00
} ) ;
} ) ;