Menu

Important: This documentation is about an older version. It's relevant only to the release noted, many of the features and functions have been updated or replaced. Please view the current version.

Enterprise Open source

compareDataFrameStructures() function

This API is provided as a preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.

compareDataFrameStructures() function

Returns true if both frames have the same list of fields and configs. Field may have diferent names, labels and values but share the same structure

To compare multiple frames use:

compareArrayValues(a, b, framesHaveSameStructure);

NOTE: this does a shallow check on the FieldConfig properties, when using the query editor, this should be sufficient, however if applicaitons are mutating properties deep in the FieldConfig this will not recognize a change

Signature

typescript
export declare function compareDataFrameStructures(a: DataFrame, b: DataFrame, skipProperties?: string[]): boolean;

Import

typescript
import { compareDataFrameStructures } from '@grafana/data';

Parameters

ParameterTypeDescription
aDataFrame
bDataFrame
skipPropertiesstring[]

Returns:

boolean