Skip to main content

dg

Namespaces

NamespaceDescription
chemCheminformatics-related routines
ClickUtils-
HtmlUtilsHtml-related utilities
ml-
Paint-
TestAutotest-related helpers
xEXPERIMENTAL - USE AT YOUR OWN RISK - API might change

Enumerations

EnumerationDescription
AGG-
AllowStickyMetaType-
ArrowType-
AxisTickmarksMode-
AxisType-
CardValueSourceType-
COLOR_CODING_TYPE-
COLUMN_TYPE-
COLUMN_TYPE_FILTERColumn filters that are broader than a concrete column type. Note that datetime columns are numerical, so use NUMERICAL_NO_DATE_TIME to exclude them.
ColumnWidthTypePredefined column width policies used by Grid.setColumnsWidthType and GridColumn.setWidthType.
CORE_VIEWER-
CorrelationType-
DEMO_DATASET-
DOCK_TYPE-
EVENT_TYPEEvent type identifiers used with grok.events.onEvent() and __obs().
FILTER_TYPE-
FlexAutoPosition-
FlexExtendedPosition-
FlexPosition-
FUNC_OPTIONSCommonly used options on the function level
GRID_COLUMN_TAGS-
GridColorCodingType-
JOIN_TYPE-
LEGEND_POSITION-
LINE_CHART_SERIES_TYPE-
LineInterpolationMode-
LINK_CLICK_BEHAVIOR-
LOG_LEVEL-
MARKER_TYPE-
NAMED_VALIDATORS-
PERMISSION-
RENDER_MODE-
RowGroupAction-
RowSet-
SCRIPT_LANGUAGE-
SEMTYPE-
ShapeType-
SIMILARITY_METRIC-
STAT_COUNTS-
STATS-
STR_AGG-
STRUCTURE_FILTER_TYPE-
SYNC_TYPE-
TextInterpretationMode-
TextOrientation-
TYPE-
USER_STATUS-
VerticalAlignType-
VIEW_TYPE-
VIEWER-
VIEWER_PROPERTY_TYPE-
VisibilityMode-

Classes

ClassDescription
AccordionAccordion control with collapsible/expandable panes. Samples: https://public.datagrok.ai/js/samples/ui/accordion
AccordionPaneA pane in the Accordion control.
ActivityDataSourceCommon functionality for handling collections of entities stored on the server. Works with Datagrok REST API, allows to get filtered and paginated lists of entities, Can be extended with specific methods. (i.e. UsersDataSource)
AdminDataSource-
AlterTableBuilderSingle-action ALTER TABLE operations, obtained via DdlBuilder.alterTable. Each method returns a DdlCommand for exactly one alteration (many databases auto-commit DDL, so batching alterations would fake an atomicity that isn't there) — run several alterations as sequential commands.
AnnotationRegionsHelper-
BalloonBalloon-style visual notifications.
BarChartViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
BigIntColumnStrongly-typed column. Use get and set to access elements by index.
BitSetEfficient bit storage and manipulation. See samples: https://public.datagrok.ai/js/samples/data-frame/aggregation
BoxPlotRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
Breadcrumbs-
BrowsePanelJS wrapper for the widget implemented in Dart.
CalendarViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
CanvasRenderer-
CardViewBase view for working with a collection of objects that reside on the server. Typically, results are filtered by applying AND operation between two filters: permanentFilter (which is set programmatically and is not visible) and searchValue entered by the user.
CellRepresents a table cell.
ChoiceInputInput control base. Could be used for editing Property values as well. The root is a div that consists of captionLabel and input.
ClientCacheClient caching service that caches results of function invocations and stores them in the IndexedDb.
CodeEditorClass for code input editor.
CodeInputInput control base. Could be used for editing Property values as well. The root is a div that consists of captionLabel and input.
ColorColor-related routines.
ColumnStrongly-typed column. Use get and set to access elements by index.
ColumnColorHelper-
ColumnComboBoxA combo box with columns as item. Supports sorting, searching, custom tooltips, column-specific rendering, drag-and-drop, etc
ColumnDialogHelper-
ColumnGridProxy class for the Dart-based column grid.
ColumnInfo-
ColumnListColumns in a [DataFrame].
ColumnMarkerHelper-
ColumnMetaHelper-
ColumnsArgs-
Completer-
ComponentBuildInfo-
ConfusionMatrixRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
ConnectionDataSourceRepresents data source, such as PostgreSQL, Oracle, S3, etc.
Context-
CorrelationPlotRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
CredentialsRepresents connection credentials Usually it is a login and a password pair Passwords are stored in the secured credentials storage See also: https://datagrok.ai/help/datagrok/solutions/enterprise/security#credentials
CredentialsDataSourceFunctionality for handling credentials collection from server and working with credentials remote endpoint Allows to manage Credentials See also: https://datagrok.ai/help/datagrok/solutions/enterprise/security#credentials
CustomCardViewBase view for working with a collection of objects that reside on the server. Typically, results are filtered by applying AND operation between two filters: permanentFilter (which is set programmatically and is not visible) and searchValue entered by the user.
DapiExposes Datagrok's server-side functionality.
DartListA proxy to a Dart List<T>.
DartWidgetJS wrapper for the widget implemented in Dart.
DartWrapper-
DataCreating, loading, querying, manipulating, joining tables.
DataConnectionRepresents a data connection
DataConnectionsDataSourceFunctionality for handling connections collection from server and working with credentials remote endpoint Allows to manage DataConnection See also: https://datagrok.ai/help/datagrok/solutions/enterprise/security
DataFrameDataFrame is a high-performance, easy to use tabular structure with strongly-typed columns of different types.
DataFrameAnnotationRegionsHelper-
DataFrameColumnColumn of type [DataFrame].
DataFrameDialogHelper-
DataFrameFormulaLinesHelperFormulaLinesHelper provides methods for working with Formula Lines. Primarily intended for use in Viewer and DataFrame metadata. Documentation: https://datagrok.ai/help/develop/how-to/show-formula-lines
DataFrameMetaHelper-
DataFramePlotHelper-
DataJobRepresents a data job
DataQueryRepresents a data query
DataQueryViewA view is typically docked in the main document area of the Grok platform. See [TableView], [SketchView], etc
DataSourceType-
DateInputInput control base. Could be used for editing Property values as well. The root is a div that consists of captionLabel and input.
DateTimeColumnStrongly-typed column. Use get and set to access elements by index.
Db-
DbInfoRepresents metadata for a database/catalog in Datagrok.
DbRelationInfoRepresents metadata for a database relation in Datagrok.
DbSchemaInfoRepresents metadata for a specific database schema in Datagrok.
DbTableStructured write access to one database table, obtained via Db.table. All operations return a MutationResult; the matching fine-grained saved-connection privilege (DataConnection.AddRows for insert, ChangeValues for update, RemoveRows for delete, AddRows+ChangeValues for upsert) and per-provider write capability are enforced server-side (unsupported operations reject with a structured capability error, never a 500). An operation that fails as a whole (rolled back, nothing applied) REJECTS the returned promise with the SQL error; per-row errors under allOrNothing: false resolve with errors/errorCount in the MutationResult. Values are always sent as bound parameters — never interpolated SQL.
DdlBuilderFluent builder for structured DDL against one connection, obtained via grok.data.db.ddl(connectionId). Mirrors TableMutationBuilder; every terminal returns a DdlCommand carrying exactly one operation.
DdlCommandA single addressed DDL operation, built by DdlBuilder. dryRun() returns the plan without executing; execute() recomputes the plan server-side and refuses destructive actions with DdlConfirmationRequiredError unless confirmed.
DdlConfirmationRequiredErrorThrown by DdlCommand.execute when the recomputed plan has destructive actions and confirmDestructive was not set. Carries the plan so the caller can render a confirmation without a second round trip, then re-run execute({confirmDestructive: true}).
DemoDatasetsProvides convenient access to demo datasets.
DensityPlotViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
Detector-
DialogA non-modal dialog. Sample: https://public.datagrok.ai/js/samples/ui/dialogs
DockContainerRepresents a dockable window. See also DockContainer, DockNode. Samples: https://public.datagrok.ai/js/samples/ui/docking/docking
DockerContainerBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
DockerContainersDataSourceFunctionality to work with Docker containers. See help: https://datagrok.ai/help/develop/how-to/docker_containers.
DockerDataSource-
DockerImageBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
DockerImagesDataSourceFunctionality to work with Docker images. See also DockerContainersDataSource.
DockManagerWindow docking manager.
DockNodeDock node. See also DockContainer, DockManager. Samples: https://public.datagrok.ai/js/samples/ui/docking/docking
DockViewA view is typically docked in the main document area of the Grok platform. See [TableView], [SketchView], etc
DomainErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainFilterErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainForbiddenErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainFrameEditorTHE single writer of a domain frame's editing state.
DomainGridAn editable grid over one domain table.
DomainManifestValidationErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainNotFoundErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainObjectHandlerThe per-table ObjectHandler for domain rows: reflective (it takes columns, labels, choices and capabilities from the runtime registry, so it works on ANY table without codegen) and delegating (every render member falls through to the platform's Dart meta for that table).
DomainQueryWhat the user is looking at, as ONE serializable object: the parameters of the platform's DomainQuery function (filters, joins, aggregations, groupBy, orderBy, projection, limit, offset). URL routing, deep links, saved filters, "open in Table View" and data-synced dashboards all serialize exactly this — there is no parallel query-state vocabulary.
DomainQueryBuilderThenable query builder (returned by no-arg query()): build with .where/.orderBy/.select/.expand/.top/.skip, then await it (rows), or finish with .df()/.first()/.count()/.exists(). Prefer the condition forms of where (and the cond/and/or helpers) over template-built filter strings — condition values are bound server-side, so any string value is safe (apostrophes included). Without .top() the server's default limit (100) applies; page larger sets with .top()/.skip(). Immutable-ish: expand()/select() return a re-typed builder; other methods mutate and return this. Invariants: the builder is PromiseLike only — there is no .catch()/.finally(), use try { await b } catch; EVERY await (or terminal) re-executes the query — two awaits are two round trips, cache the rows instead.
DomainRegistryClientReflection over the client-side domain registry (see DomainsDataSource.registry): schemas → tables → columns → Property metadata, loaded once per session and shared with the built-in domain UI. Tables are addressed as '<schema>.<table>'.
DomainRestrictErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainRowA single row of a DomainTable. Its semantic type is the row's entity type name, '<schema>.<table>' — the string an ObjectHandler keys on to override rendering per table (see Grit's grit.issue handler).
DomainSavedFilterA saved filter preset of a domain table — a small shareable entity carrying the filter panel's state maps (entity-filters §7). Managed through grok.dapi.domains.table(...).filters; wrapped here so preset entities work with the standard entity machinery (sharing, favorites, Dapi.getEntities).
DomainSavedFiltersClientSaved filter presets of one domain table (see DomainTableClient.filters): small shareable entities carrying the filter panel's state maps. Sharing uses the standard entity permission machinery (Dapi.permissions); the server scopes list to what the caller can see.
DomainSchemaA registered domain schema declared by a plugin manifest (databases//schema.json).
DomainSchemaClientLifecycle handle for one registered domain schema (see DomainsDataSource.schema): manifest export, partial applies with dry-run change plans, whole-schema audit, and full purge. Mutations apply to user-managed schemas only (package schemas deploy on publish).
DomainsDataSourceGeneric client for domain tables — entity-mapped PostgreSQL schemas that plugins declare via databases/<schema>/schema.json manifests. Rows are plain JSON objects; column metadata and security come from the server-side schema registry.
DomainTableA securable table inside a DomainSchema; its rows are typed by a per-table entity type named '.'.
DomainTableClientRow CRUD for one domain table. Reads return only rows and columns the current user can see; writes are validated, permission-checked, and audited server-side. Pass a row interface as TRow for typed reads/writes, and an insert interface as TInsert so insert enforces required columns (grok api-generated clients pass both; see DomainsDataSource.table).
DomainValidationErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainVersionConflictErrorBase of all structured /domains failures; [body] is the server's error envelope.
DomainViewThe platform's Domain View for one domain table — the /domains/<schema>/<table> page, creatable programmatically and embeddable: card / brief / grid modes, search, sort, paging, the server-backed filter panel, in-grid editing with one-transaction save, and the per-table ObjectHandler's rendering and commands. Show it with grok.shell.addView(v), or mount v.root anywhere.
DragDropArgsArguments passed to drag-and-drop callbacks (see DG.ui.makeDroppable). Wraps the Dart DragDropArgs handle exposed via the GrokJsObject mixin.
DropDownBase class for controls that have a visual root and a set of properties.
EmailDialogGeneric markdown-body email dialog with attachments.
EntitiesDataSourceFunctionality for handling entities collection from server Allows to manage Entity
EntityBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
EntityPropertyA dynamic property associated with the entity.
EntityType-
EventBusCentral event hub.
EventData-
EventsGlobal platform events.
EventTypeDescriptor for a named event that can be fired on an EventBus. Wraps a Dart EventType<T> instance.
FavoritesJS wrapper for the widget implemented in Dart.
FileInfo-
FilesProvides convenient file shares access *
FilesDataSourceProvides access to file operations in the Datagrok file system.
FilesViewFile browser view. Contains the file tree, search panel and preview components.
FilesWidgetFile browser widget
FilterBase class for DataFrame-bound filtering controls. Supports collaborative filtering by efficiently working together with other filters.
FilterGroupRepresents a group of filters that are located together.
FloatColumnStrongly-typed column. Use get and set to access elements by index.
FormRepresents a form that can be user-designed or edited.
FormulaLinesHelperFormulaLinesHelper provides methods for working with Formula Lines. Primarily intended for use in Viewer and DataFrame metadata. Documentation: https://datagrok.ai/help/develop/how-to/show-formula-lines
FormViewerDataFrame-bound viewer that contains Form
FuncRepresents a function
FuncCallRepresents a function call https://datagrok.ai/help/datagrok/concepts/functions/function-call
FuncCallEditorBase class for widgets or views that serve as editors for FuncCall. Extend it and use it in editor functions. Editor functions should return an implementation of this class for the platform to handle validation correctly. An editor function can be attached to another function using the editor tag: editor: Plugin:EditorFuncName.
FuncCallParamRepresents a parameter of a function.
FuncOptions-
FuncParamOptions-
FuncsDataSourceFunctionality for handling functions collection from server Allows managing Func
FunctionsGrok functions
FunctionsWidgetJS wrapper for the widget implemented in Dart.
GridHigh-performance, flexible spreadsheet control
GridCellRepresents a grid cell
GridCellRenderArgsGrid cell rendering args.
GridCellRenderer-
GridCellRendererProxyProxy class for the Dart-based grid cell renderers.
GridCellStyleRepresents grid cell style.
GridCellStyleEx-
GridCellWidgetRenders the content of the specified [gridCell], and provides interactivity as well.
GridColumnRepresents a grid column
GridColumnListRepresents grid columns.
GridFilterBaseJS wrapper for the widget implemented in Dart.
GridTooltipArgs-
Group-
GroupByBuilderFluid API for building an aggregation query against a DataFrame. Build a query by calling the following methods: key, pivot, count, uniqueCount, missingValueCount, valueCount, min, max, sum, avg, stdev, variance, q1, q2, q3.
GroupsDataSourceFunctionality for handling groups collection from server Allows to manage Group
HistogramViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
HistoryEntry-
HtmlTableJS wrapper for the widget implemented in Dart.
HttpDataSourceCommon functionality for handling collections of entities stored on the server. Works with Datagrok REST API, allows to get filtered and paginated lists of entities, Can be extended with specific methods. (i.e. UsersDataSource)
InfoDataSource-
InputBaseInput control base. Could be used for editing Property values as well. The root is a div that consists of captionLabel and input.
InputFormA form with multiple inputs inside
InputType-
JsInputBaseBase class for JS value editors
JsViewerSubclass JsViewer to implement a DataFrame-bound Datagrok viewer in JavaScript. See an example on github: https://github.com/datagrok-ai/labs/tree/master/packages/Leaflet
LayoutsDataSourceFunctionality for handling layouts collection from server Allows to manage ViewLayout
LegendColumn legend for viewers
LineChartViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
LogDataSourceCommon functionality for handling collections of entities stored on the server. Works with Datagrok REST API, allows to get filtered and paginated lists of entities, Can be extended with specific methods. (i.e. UsersDataSource)
LogEventBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
LogEventParameterBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
LogEventParameterValueBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
LogEventTypeBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
Logger-
LruCacheLeast recently used cache. Inspired by https://github.com/Yomguithereal/mnemonist/blob/master/lru-cache.js
MarkdownInputBase class for JS value editors
MatrixPlotRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
MenuMenu (either top menu or popup menu). Top menu sample: https://public.datagrok.ai/js/samples/ui/menu Popup menu sample: https://public.datagrok.ai/js/samples/ui/popup-menu
ModelRepresents a predictive model
MultiChoiceInputInput control base. Could be used for editing Property values as well. The root is a div that consists of captionLabel and input.
MultiViewSubclass ViewBase to implement a Datagrok view in JavaScript.
NetworkDiagramViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
Notebook-
NotificationsDataSourceCommon functionality for handling collections of entities stored on the server. Works with Datagrok REST API, allows to get filtered and paginated lists of entities, Can be extended with specific methods. (i.e. UsersDataSource)
ObjectColumnStrongly-typed column. Use get and set to access elements by index.
ObjectPropertyBagA dynamic property bag that provides convenient access to an object's properties.
PackageRepresents a package, which is a unit of distribution of content in the Datagrok platform.
PackageLogger-
PcPlotRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
Permission-
PermissionsDataSource-
PieChartViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
PivotViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
PointRepresents a point.
ProgressIndicator-
ProjectRepresents a project
ProjectsDataSourceFunctionality for working with remote projects
ProjectsViewProjects view
PropertyStrongly-typed property associated with an object. Used for reflection, serialization, UI generation, and other introspection-dependent tasks.
PropertyGridJS wrapper for the widget implemented in Dart.
QnumA set of static methods for working with qualified numbers. The internal representation of a qualified number is a regular double precision floating point number (IEEE 754), except the two least significant bits in mantissa are reserved for holding the qualifier ([LESS], [EXACT], [GREATER]).
RangeSliderA slider that lets user control both min and max values.
RectRepresents a rectangle.
RocCurveRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
RowRepresents a row in a DataFrame.
RowGroup-
RowListRepresents rows of the [DataFrame].
RowMatcherRow matcher.
ScatterPlotViewer2D scatter plot
SchemaRepresents dynamic property schema, associated with the entity type.
Script-
ScriptEnvironmentRepresents a script environment
ScriptLanguage-
ScriptsViewScripts view
ScriptViewScript view
SearchResult-
SemanticValue-
ServerMessageTypes-
SettingsUser-specific platform settings.
ShellGrok visual shell, use it to get access to top-level views, tables, methods, etc.
ShellContextPanelRepresents context panel that shows properties for the current object and is toggleable by pressing F1
ShellHelpPanelRepresents help panel that shows help for the current object and is toggleable by pressing F1
SpaceChildrenClientClient for querying and filtering children of a space. Children can include subspaces (Projects), files (FileInfo), and various entities like scripts, queries, and connections.
SpaceClientClient for working with a specific space. Provides methods for managing subspaces, entities (scripts, queries, connections), and files.
SpaceFilesClientClient for file operations within a space's storage. Files in a space are stored in the space's dedicated storage connection. Directory operations are synchronized with the space hierarchy - creating a directory creates a corresponding subspace, and renaming a directory renames the subspace.
SpacesDataSourceData source for working with Spaces - hierarchical containers for organizing entities and files. Spaces support nested subspaces, file storage, and can contain various entities like scripts, queries, etc.
SpaceViewHierarchical view of a Datagrok Space — the same widget the Browse tree opens when you click a Space (a Project where isSpace == true). Includes the search box, the "+" ribbon button to add a child space, and the card grid of children (subspaces, files, entities).
StatsRepresents basic descriptive statistics calculated for a Column. See samples: https://public.datagrok.ai/js/samples/data-frame/stats
StickyMetaAPI for Sticky meta. Allows attaching arbitrary metadata on custom entities. Can be applied to a column of entities based on semtype or column tags.
StreamSubscriptionSubscription to an event stream. Call [cancel] to stop listening.
StringUtils-
TabControlTab control that hosts panes inside. See also TabPane
TableInfo-
TableMutationBuilderFluent builder for structured UPDATE/DELETE mutations. A thin wrapper over DbTable that accumulates SET assignments and WHERE conditions. In phase A a WHERE condition is equality by value; a string value may use string patterns (e.g. contains foo). Numeric/date range grammar (> 5, 10-20) in where is phase B. Build via grok.data.db.buildMutation(...).
TableQueryRepresents a table query
TableQueryBuilderTable query builder that works with database tables
TablesDataSourceFunctionality for working with remote tables
TableViewA View that is associated with a DataFrame and exposes exploratory data analysis functionality. This view gets opened whenever a new table is added to the workspace when a user drag-and-drops a CSV file, or opens a table in any other way.
TabPaneRepresents a pane of either TabControl or Accordion
TagEditor-
TagElement-
Tags-
TaskBarProgressIndicator-
TileViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
ToolboxPage-
TreeMapRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
TreeViewGroupTree view node. Sample: https://public.datagrok.ai/js/samples/ui/tree-view
TreeViewNodeTree view node. Sample: https://public.datagrok.ai/js/samples/ui/tree-view
TrellisPlotViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
TypeAheadInput control base. Could be used for editing Property values as well. The root is a div that consists of captionLabel and input.
TypedEventArgs-
UndoServiceMulti-level undo/redo. Records are kept in memory only, are bounded by count and by size, and are dropped when the table or view they belong to is closed.
UsageType-
UserRepresents a user of the Datagrok platform.
UserDataStorage-
UserNotification-
UserReportBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
UserReportsDataSourceCommon functionality for handling collections of entities stored on the server. Works with Datagrok REST API, allows to get filtered and paginated lists of entities, Can be extended with specific methods. (i.e. UsersDataSource)
UserReportsRuleBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
UserReportsRulesDataSourceCommon functionality for handling collections of entities stored on the server. Works with Datagrok REST API, allows to get filtered and paginated lists of entities, Can be extended with specific methods. (i.e. UsersDataSource)
UsersDataSourceFunctionality for handling Users collection from server and working with Users remote endpoint Allows to load current user and list of all Datagrok users with filtering and pagination See example: https://public.datagrok.ai/js/samples/dapi/who-am-i
UserSessionRepresents a user session in the Datagrok platform.
Utils-
ValueMatcherValue matcher. See usage example: https://public.datagrok.ai/js/samples/data-frame/value-matching/value-matcher
ViewA view is typically docked in the main document area of the Grok platform. See [TableView], [SketchView], etc
ViewBaseSubclass ViewBase to implement a Datagrok view in JavaScript.
ViewerRepresents a viewer. See also https://datagrok.ai/help/develop/how-to/manipulate-viewers
ViewerAnnotationRegionsHelper-
ViewerEvent-
ViewerFormulaLinesHelperFormulaLinesHelper provides methods for working with Formula Lines. Primarily intended for use in Viewer and DataFrame metadata. Documentation: https://datagrok.ai/help/develop/how-to/show-formula-lines
ViewerMetaHelper-
ViewInfoBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
ViewLayoutBase class for system objects stored in the database in a structured manner. Contains base properties: id, name and path
ViewsDataSourceFunctionality for handling views information from server Allows to manage ViewInfo
VirtualViewRepresents a virtual view, where visual elements are created only when user scrolls them into view.
VisualDbQueryEditorJS wrapper for the widget implemented in Dart.
WidgetBase class for controls that have a visual root and a set of properties.
WidgetDescriptorProvides metadata about the widget (such as name, description, available events and properties) without having to instantiate it. Used for command palettes, AI, etc
WindowsControls tool windows visibility
WizardEXPERIMENTAL - USE AT YOUR OWN RISK - API might change

Interfaces

InterfaceDescription
AnnotationRegionRepresents a core annotation region parameters.
AreaAnnotationRegionRepresents an area annotation region (defined by polygon points) parameters.
BalloonOptions-
CellChangeArgs-
CellRangeArgs-
ColumnChangeArgs-
ColumnsFormatCsvExportOptionsColumn name -> format
CsvExportOptionsCsv export options to be used in DataFrame.toCsv
DatabaseConnectionPropertiesRepresents basic properties of database connection.
DataConnectionCachePropertiesRepresents connection cache properties. See also: https://datagrok.ai/help/develop/how-to/function_results_cache
DataConnectionPropertiesRepresents data connection properties.
DataFrameArgs-
DbColumnProperties-
DbRelationProperties-
DbTableProperties-
DdlColumnColumn definition for DdlBuilder.createTable / alterTable(...).addColumn. type is a dg type (string, int, bigint, float, bool, datetime) mapped to the provider's native type server-side.
DdlIndexIndex definition for DdlBuilder.createTable.
DdlPlanThe execution plan of a DDL operation (DdlCommand.dryRun, or riding a DdlConfirmationRequiredError): the exact per-provider SQL plus live-data pre-checks. The apply path always recomputes the plan server-side — an earlier dry run is informational, never trusted.
DestructiveActionOne destructive (or refused) action of a DdlPlan.
DomainActionA declarative action offered for a domain row (see DomainObjectHandler.getRibbonActions) — the JS mirror of the Entity View ribbon icons. Only actions the current user may perform are returned, so a consumer renders the list as-is without any permission checks of its own.
DomainAggregateMeasureOne measure of DomainAggregateSpec: fn over column (count needs no column); the output name is as (defaults to fn or <fn>_<column>).
DomainAggregateSpecSpec for domain table aggregate.
DomainAuditEntryWire shape of _audit rows (repository.dart rowAudit/tableAudit/schemaAudit selects).
DomainBatchOptionsOptions for domain table batch.
DomainBatchReportBatch upload report of domain table batch.
DomainBatchRowResultPer-row outcome inside a DomainBatchReport.
DomainCellErrorOne cell-level problem, as stored in DomainFrameEditor.ERRORS_COLUMN: 'error' blocks DomainFrameEditor.save, 'conflict' (a dismissed version conflict) only marks the cell.
DomainChildTableRefFK-inverted reference to a child (detail) table — drives detail-table links and entity-view child tabs (see DomainRegistryClient.tableInfo).
DomainColumnErrorOne per-column failure of a validation-failed write.
DomainConditionOne condition node. value may be a list (= ANY / != ALL), null (IS NULL / IS NOT NULL under '='/'is'), or '@current' for the current user on user columns. Values are ALWAYS bound server-side — never interpolate values into filter strings.
DomainDatetimeColumnsResolved datetime columns of a table: its own plus those of its 'details:' child tables, keyed by the result field (see DomainTableClient).
DomainDeleteReportReport of domain table deleteWhere: rows actually soft-deleted in this call, and whether more matching deletable rows remain (loop while hasMore).
DomainDeleteResultResult of one deleted row.
DomainDetailTabOne FK-inverted child ("detail") table of a domain row — what the built-in Entity View shows as a child tab (see DomainObjectHandler.getDetailTabs).
DomainFacetCategoriesResultResult of a 'categories' facet; hasMore set when the category cap was hit.
DomainFacetCategoryOne category bucket of a 'categories' facet: total ignores the filter, filtered respects it (minus the facet's own column); ref columns group by id and carry the referenced row's display name in display.
DomainFacetCountResultResult of a 'count' facet: the filtered row count.
DomainFacetHistogramResultResult of a 'histogram' facet: buckets respect the filter, totalBuckets ignore it.
DomainFacetMinMaxResultResult of a 'minMax' facet (row predicate only — the stable-axis rule ignores the filter).
DomainFacetPlanResultResult of a 'plan' facet: per-column profile for choosing filter-control types.
DomainFacetSpecOne facet request of DomainFacetsSpec; id keys its result in the response.
DomainFacetsSpecSpec for domain table facets: one request computes every facet in a single round trip. Category counts, histogram buckets, and 'count' are computed under filter with the conditions on that facet's own column stripped, so a filter control shows counts under all OTHER filters (classic faceted search). Exception: 'minMax', 'plan', and histogram BOUNDS are computed under the row predicate only — the stable-axis rule ignores filter so a narrowing filter never re-derives the axis. At most 32 facets per request.
DomainFrameEditorOptionsOptions of DomainFrameEditor.attach / DomainFrameEditor.create.
DomainGrantOne direct permission row on a domain registry entity (see DomainTableClient.grants).
DomainGridOptionsOptions of DomainGrid.create.
DomainInsertResultResult of one inserted row.
DomainPendingOpOne pending write of DomainFrameEditor.buildOps, with the frame row it came from (how a failing opIndex finds its row).
DomainPickerOptionsOptions of DomainObjectHandler.pickRow.
DomainQueryParamsParameter values of the DomainQuery function — the serializable representation of what a domain view is showing (filter elements, ordering, cap), as DomainView.query reports it. Feeding it back to the function (DomainQuery.run) reproduces the subset as a DataFrame, with the creation script recorded.
DomainQuerySpecQuery options for domain table query/queryDf.
DomainRelationLinkOne link of an expanded many-to-many relation: the target row's id and its display name (name column → dash-joined business key → id, exactly as the row renders everywhere else). A relation expand (expand: ['labels']) returns these arrays under the relation's own name, capped at 100 and ordered by display name; the array is [], never null, for an owner with no visible links.
DomainRowErrorsPer-row failure list of a validation-failed write (DomainValidationError.rows).
DomainSavedFilterInfoA saved filter preset of a domain table — a small shareable entity carrying the filter panel's state maps verbatim (see DomainSavedFiltersClient).
DomainSaveResultWhat one DomainFrameEditor.save wrote (all of it in ONE transaction). Ids and versions the server returned are written back into the frame; a host that keeps its own row objects re-queries after a successful save.
DomainTableCapabilitiesEffective capabilities of the CURRENT user on one domain table (see DomainTableClient.capabilities). Composed client-side from server-truth permission probes on the FINAL securing entity through the master delegate chain, plus the writable-column mirror of column security.
DomainTableClientOptionsOptions of DomainsDataSource.table. Datetime columns resolve from the domain registry by default — these overrides exist for legacy generated clients and for callers that must avoid the registry.
DomainTableInfoRegistry metadata of one domain table (see grok.dapi.domains.registry).
DomainTransactionOpOne operation of DomainsDataSource.transaction.
DomainUpdateResultResult of one updated row: version is the new (incremented) row version.
DomainViewOptionsOptions of DomainView.create.
DropDownListOptionsOptions for dropdown with list items
DropDownOptionsOptions for dropdown
EmailEmail that can be sent using the configured SMTP service
EmailAttachmentAttachment for an [Email].
EmailDialogOptions-
EmailDialogResultFinal values produced by [EmailDialog] when SEND is pressed. Map directly into grok.dapi.admin.sendEmail (html/text/attachments).
EventArgs-
FilterState-
FormulaAnnotationRegionRepresents a formula annotation region (defined by two formula lines) parameters.
FormulaLineFormulaLine available parameters.
FormulaLineMetaFormulaLine meta information.
FuncRoleDescription-
GridCellArgs-
IBarChartSettings-
IBoxPlotSettings-
ICalendarSettings-
ICardSettings-
IConfusionMatrixSettings-
ICorrelationPlotSettings-
IDensityPlotSettings-
IDomainQueryExecutorMinimal structural client the builder executes against (avoids a domains.ts → dapi.ts cycle).
IDomainTableContextThe prefetched table context a SYNCHRONOUS widget factory needs: the typed client plus the registry metadata and capabilities, resolved once by domains.table(...) (which is why form(), grid() and friends need no await).
IEditorHostA widget or page that answers for a set of DomainFrameEditors.
IEventTypeEvent type descriptor as returned by IWidgetStatus.events.
IFiltersSettings-
IFormSettings-
IFunctionCallOptions-
IFunctionRegistrationData-
IGridCellStyle-
IGridSettings-
IHistogramSettings-
IInputStatusLive state of ONE named input of a widget, as reported by IWidgetStatus.inputs — the machine-readable counterpart of what the user sees in a form. Values and validation are read on demand, never cached: a widget reports whatever it holds at the moment Widget.getWidgetStatus is called.
ILineChartSettings-
IMapViewerSettings-
IMarkupViewerSettings-
IMatrixPlotSettings-
IMenuColorPaletteOptionsSee Menu.colorPalette
IMenuColumnSelectorOptionsSee IMenuSingleColumnSelectorOptions and IMenuMultiColumnSelectorOptions
IMenuFontEditorOptionsSee Menu.fontEditor
IMenuHeaderOptionsSee Menu.header
IMenuItemOptions-
IMenuItemsOptionsSee Menu.items
IMenuMultiColumnSelectorOptionsSee Menu.multiColumnSelector
IMenuSingleColumnSelectorOptionsSee Menu.singleColumnSelector
INetworkDiagramSettings-
InputArgs-
IPcPlotSettings-
IPieChartSettings-
IPivotViewerSettings-
IPoint-
IPointsViewerSettings-
IPropertyRepresents a property. See also Property.
IRectBoundsBounding rectangle returned by IWidgetStatus.hitAreas.
IRocCurveSettings-
IScatterPlot3dSettings-
IScatterPlotSettings-
IServerMessageEventArgs-
IShowMenuOptions-
ISparklinesSettings-
IStatsViewerSettings-
ISummarySettings-
ITabControlOptionsSee TabControl.create and ui.tabControl
ITileViewerSettings-
ITreeMapSettings-
ITrellisPlotSettings-
IViewStateApplicationOptions-
IWidgetActionsWhat a widget must implement to be acted on by the vocabulary. Every member is optional: a widget offers the actions it can perform (see DomainForm.getFunctions), and one that cannot is simply not offered.
IWidgetStatusRuntime snapshot of a widget's structure, used by the automated testing system. Returned by Widget.getWidgetStatus.
MapChangeArgs-
MultiViewOptions-
MutationResultThe structured result of a database write (DbTable insert/upsert/update/delete). Mutations never return a DataFrame. inserted/updated/skipped are best-effort — some dialects cannot tell inserts from updates on an upsert and leave the split null.
ProjectOpenOptions-
PropertyChangeArgs-
QnumColumnCreationOptionsOptions for ColumnList.addNewQnum.
RowChangeArgs-
RowErrorOne failed row of a MutationResult.
SemTypeInfoMetadata associated with the semantic type.
ServiceInfo-
Size-
UndoRecordArgs-
UnsavedPromptOptionsWording of promptUnsavedChanges.
ViewArgs-
ViewChangeArgs-
ViewerArgs-
WizardPageEXPERIMENTAL - USE AT YOUR OWN RISK - API might change

Type Aliases

Type AliasDescription
AggregationType-
AnyDomainTableClientA domain client with its row/insert/column/expand/update generics erased — what the REFLECTIVE widgets take. A TYPED client fits it, so a generated <Table>Ui (or a DomainTable handle) keeps its own generics and is still usable here. The update generic must be erased explicitly: its Partial<TRow> default is a real object type, and update() would then reject a typed client's payload.
CategoryDataArgs-
CodeConfig-
ColorCodingType-
ColorType-
ColumnAggregationType-
ColumnId-
ColumnType-
ColumnTypeFilter-
Comparer-
CorrPlotCellArgs-
CsvImportColumnOptions-
CsvImportOptions-
DemoDatasetName-
DockerContainerStatus-
DockType-
DomainAggregateRowOne result row of aggregate — keys are the group columns and measure aliases.
DomainColumnRefColumn reference: a declared column of the table, a system column, or a dotted FK path ('project_id.name', up to 3 forward hops). Used by the condition, sort, and aggregate column slots — those accept system columns even when a hand-written [TColumn] union omits them (generated <Table>Column unions include them). Other slots (equality-map where, columns, select(), fetchFields(), column security) stay TColumn-typed.
DomainConditionNodeInside a tree, a bare string is a connector; an omitted connector means 'and' (sticky — the last seen connector repeats).
DomainConditionOperatorOperators of the canonical condition tree (server: filter_compiler.dart:149-153 + fuzzy).
DomainConditionTreeThe canonical condition tree: conditions and nested trees joined by connector strings.
DomainFacetKindThe facet kinds of DomainFacetSpec.
DomainFacetResultOfMaps a facet kind to its result type (keys the typed facets() response).
DomainFilterEvery filter slot accepts the smart-filter string (human shorthand), a single condition, or the canonical condition tree — uniformly across query, queryDf, aggregate, facets, count, exists, and deleteWhere (server: DomainFilterCompiler.toTree).
DomainFilterValueValue of one condition: scalar, list (= ANY / != ALL), null (IS [NOT] NULL), or dayjs (sent as ISO-8601). Always bound server-side.
DomainOpResultResult of one transaction op (see DomainOpResultFor for the typed-tuple form).
DomainOpResultForResult type of one transaction op, keyed on its op discriminant — powers the mapped-tuple transaction() signatures (per-op result types, no positional casts).
DomainPermissionGrantable permission on a domain registry entity (table, schema, or column schema). 'Extend' is grantable on SCHEMA entities only — it lets the holder add their own tables and columns to a package-managed schema the plugin opted in to.
DomainRowInsertInsert payload for domain table insert: row values plus an optional idempotency key (for tables that declare "idempotency": true).
DomainRowStatePer-row editing state, as stored in DomainFrameEditor.STATE_COLUMN.
DomainSystemColumnThe system columns every domain table carries (always projected on reads).
DomainTxValuesTyped transaction-op values: each column also accepts a '$<ref>' back-reference.
DropDownMenuBuilderBuilder function for full Menu control (separators, headers, etc.)
DropDownMenuItemsMenu items definition: functions for items, objects for nested groups.
ElementOptions-
FieldOrder-
FieldPredicate-
FileImportArgs-
fileShares-
GridColumnTooltipType-
GroupAggregation-
GroupDescription-
GroupsDescription-
HorzAlign-
ICodeEditorOptions-
IndexPredicate-
IndexSetter-
JoinType-
JsonArray-
JsonObject-
JsonPrimitive-
JsonValue-
LegendPosition-
LineChartLineArgs-
LogMessage-
MarkdownConfig-
MarkerCodingType-
MatchType-
ObjectType-
PropertyGetter-
PropertySetter-
RangeSliderStyle-
RowDataArgs-
RowPredicate-
ScriptingLanguage-
SearchProviderthe home view should be under the name home and rest should match the views that they are applicable to
SemType-
SimilarityMetric-
SliderOptions-
StringPredicate-
StructureFilterType-
SyncType-
TableJoin-
TextWrap-
Type-
TypeAheadCallbackSourceAsync suggestion callback for TypeAheadConfig.source: receives the typed query and resolves to suggestions — strings or objects with a label (extra fields ride along and are passed to onSubmit intact, e.g. {label, value} for lookups resolving to an id).
TypeAheadConfig-
UnsavedOutcomeWhat the user chose in promptUnsavedChanges (dismissing it is 'cancel').
ValueValidator-
VertAlign-
ViewerPropertyType-
ViewerType-
ViewSpecificSearchProvider-
ViewType-

Variables

VariableDescription
DEFAULT_SKETCHER-
DOMAIN_QUERY_ROW_LIMITThe DomainQuery function's client-side row ceiling (the server clamps to it): the limit DomainQuery.toSpec writes when the query declares none, so a spec never silently inherits the server's default of 100.
DOMAIN_SYSTEM_COLUMNSRuntime list of the system columns (type-level counterpart: DomainSystemColumn).
FileSource-
FLOAT_NULL-
FUNC_TYPES-
functionRoles-
INT_NULL-
MapProxyProxies a Dart Map, API-compliant to ES 2015+
QNUM_EXACT-
QNUM_GREATER-
QNUM_LESS-
TAGS-
TYPES_SCALAR-
UNITS-
WHITE_MOLBLOCK-
WHITE_MOLBLOCK_V_3000-

Functions

FunctionDescription
__obsCreates an RxJS Observable from a Dart event stream.
_getIteratorCreates a JavaScript iterator from a Dart iterator.
_identityInt32-
_isDartium-
_options-
_propsToDartConverts entity properties between JavaScript and Dart. See also: include
_subWraps a Dart stream subscription as a JavaScript StreamSubscription.
_toIterableWraps a Dart iterable as a JavaScript Iterable. Allows using Dart collections in for...of loops.
_toJsonConverts a value to JSON string, handling null.
acquireDomainContextResolves [client]'s registry metadata and the caller's capabilities in ONE round of requests — the async boundary every synchronous widget factory sits behind (domains.table(), DomainGrid.create(), EntityListWidget.create()).
andAND-combined condition tree: and(a, b, c)[a, 'and', b, 'and', c].
applyDomainGridStylesAdds the grid stylesheet to the document once — safe to call per component.
callFuncWithDartParameters-
condBound condition node: cond('name', '=', "O'Brien"). The value travels in the condition tree and is bound server-side — NEVER interpolated into a filter string, so any string value is expressible (apostrophes included, which the smart-filter grammar cannot quote).
confirmDiscardChangesTHE gate an app puts in front of a rebuild: resolves to whether the caller may proceed, having saved or discarded whatever was pending.
debounce-
delay-
domainActionFuncWraps a custom DomainAction as a widget-action Func, through the same idempotent registration — a plugin's extra action is as discoverable as Save.
domainCallAwaits [p], rethrowing interop-marked failures as typed DomainErrors.
format-
histogram-
identityReturns an 'identity' array where the element in idx-th position is equals to idx.
observeStreamConverts Dart stream to rxjs.Observable.
orOR-combined condition tree: or(a, b, c)[a, 'or', b, 'or', c].
paramsToJsConverts a list of Dart objects to JavaScript objects. Iterates through the array and calls toJs on non-scalar types.
promptUnsavedChangesAsks what to do with the pending changes of [editors] before something that would discard them. Resolves to the user's decision WITHOUT applying it — confirmDiscardChanges is the one that saves or discards.
rangeGenerates [count] increasing integer numbers, starting with 0.
renderMultipleHistograms-
retryOnVersionConflictRuns [action], retrying on DomainVersionConflictError (for transaction-based read-modify-write flows — put the fresh read INSIDE [action]); rethrows anything else and the final conflict. maxRetries counts retries AFTER the initial attempt (default 5 retries = up to 6 attempts). Retries run immediately, without backoff — conflicts resolve by re-reading, not waiting; add your own delay for high-contention hot rows.
splitDomainTableSplits the '<schema>.<table>' address every domain client and UI component takes, throwing on a malformed one — the single spelling of that contract.
timeTimes the execution of function f
timeAsyncTimes the execution of asyncronous function f
toDartConverts a JavaScript object to its Dart representation.
toDomainErrorMaps the interop's '#domainError' plain object to a typed class; passes anything else through.
toJsConverts a Dart object to its JavaScript wrapper or native JS value.

References

EntityMetaDartProxy

Re-exports EntityMetaDartProxy


ObjectHandler

Re-exports ObjectHandler