Shell

Defined in: src/shell.ts:40

Grok visual shell, use it to get access to top-level views, tables, methods, etc.

Example

grok.shell.addTableView(grok.data.demo.biosensor(1000));

Constructors

Constructor

new Shell(): Shell

Returns

Shell

Properties

Property	Type	Defined in
build	AppBuildInfo	src/shell.ts:43
settings	Settings & SettingsInterface	src/shell.ts:42
windows	Windows	src/shell.ts:41

Accessors

bottomPanel

Get Signature

get bottomPanel(): HTMLDivElement

Defined in: src/shell.ts:146

Returns

HTMLDivElement

---

browsePanel

Get Signature

get browsePanel(): BrowsePanel

Defined in: src/shell.ts:150

Returns

BrowsePanel

---

dockManager

Get Signature

get dockManager(): DockManager

Defined in: src/shell.ts:361

Returns

DockManager

---

favorites

Get Signature

get favorites(): Entity[]

Defined in: src/shell.ts:154

Returns

Entity[]

---

lastError

Get Signature

get lastError(): Promise<string | undefined>

Defined in: src/shell.ts:107

Last error state

Returns

Promise<string | undefined>

Set Signature

set lastError(s): void

Defined in: src/shell.ts:109

Parameters

Parameter	Type
s	any

Returns

void

---

o

Get Signature

get o(): any

Defined in: src/shell.ts:119

Current object (rendered in the context panel)

Returns

any

Set Signature

set o(x): void

Defined in: src/shell.ts:120

Parameters

Parameter	Type
x	any

Returns

void

---

preview

Get Signature

get preview(): View | null

Defined in: src/shell.ts:79

The view currently displayed in preview mode.

This allows inspecting an object (like a dataset) temporarily without fully opening it or adding it to the workspace.

Returns

View | null

Set Signature

set preview(view): void

Defined in: src/shell.ts:80

Parameters

Parameter	Type
view	View | null

Returns

void

---

project

Get Signature

get project(): Project

Defined in: src/shell.ts:86

Current project

Returns

Project

---

projects

Get Signature

get projects(): Project[]

Defined in: src/shell.ts:91

Returns the list of currently opened projects

Returns

Project[]

---

sidebar

Get Signature

get sidebar(): TabControl

Defined in: src/shell.ts:131

Returns

TabControl

---

startUri

Get Signature

get startUri(): string

Defined in: src/shell.ts:370

Returns

string

---

t

Get Signature

get t(): DataFrame

Defined in: src/shell.ts:65

Current table, or null.

Returns

DataFrame

---

tableNames

Get Signature

get tableNames(): string[]

Defined in: src/shell.ts:317

Names of the currently open tables

Returns

string[]

---

tables

Get Signature

get tables(): DataFrame[]

Defined in: src/shell.ts:323

List of currently open tables

Returns

DataFrame[]

---

tableViews

Get Signature

get tableViews(): Iterable<TableView>

Defined in: src/shell.ts:333

Returns currently open table views

Returns

Iterable<TableView>

---

topMenu

Get Signature

get topMenu(): Menu

Defined in: src/shell.ts:136

Returns

Menu

---

topPanel

Get Signature

get topPanel(): HTMLDivElement

Defined in: src/shell.ts:141

Returns

HTMLDivElement

---

tv

Get Signature

get tv(): TableView

Defined in: src/shell.ts:83

Current table view, or null

Returns

TableView

---

user

Get Signature

get user(): User

Defined in: src/shell.ts:114

Current user

Returns

User

---

v

Get Signature

get v(): ViewBase

Defined in: src/shell.ts:70

Current view

Returns

ViewBase

Set Signature

set v(view): void

Defined in: src/shell.ts:71

Parameters

Parameter	Type
view	ViewBase

Returns

void

---

viewer

Get Signature

get viewer(): Viewer

Defined in: src/shell.ts:127

Current viewer

Returns

Viewer

Set Signature

set viewer(x): void

Defined in: src/shell.ts:128

Parameters

Parameter	Type
x	Viewer

Returns

void

---

views

Get Signature

get views(): Iterable<View>

Defined in: src/shell.ts:328

Returns currently open views

Returns

Iterable<View>

Methods

add()

add(item): Shell

Defined in: src/shell.ts:199

Adds an item to the workspace. It could be a DataFrame, a View, or an HtmlElement. Throws an error, if the item has a different type.

Parameters

Parameter	Type
item	HTMLElement | DataFrame | ViewBase

Returns

Shell

---

addPreview()

addPreview(v, dockType?, width?, context?): ViewBase

Defined in: src/shell.ts:220

Adds a preview for current Browse Panel node.

Parameters

Parameter	Type	Default value
v	ViewBase	undefined
dockType	"fill" | "left" | "right" | "up" | "down"	DOCK_TYPE.FILL
width	number | null	null
context	FuncCall | null	null

Returns

ViewBase

---

addTable()

addTable(table): DataFrame

Defined in: src/shell.ts:96

Adds a table to the workspace.

Parameters

Parameter	Type
table	DataFrame

Returns

DataFrame

---

addTablePreview()

addTablePreview(table, dockType?, width?): TableView

Defined in: src/shell.ts:249

Adds a preview for the specified table.

Parameters

Parameter	Type	Default value	Description
table	DataFrame	undefined	-
dockType	"fill" | "left" | "right" | "up" | "down" | null	DOCK_TYPE.FILL	-
width	number | null	null	-

Returns

TableView

---

addTableView()

addTableView(table, dockType?, width?): TableView

Defined in: src/shell.ts:258

Adds a view for the specified table.

Parameters

Parameter	Type	Default value	Description
table	DataFrame	undefined	-
dockType	"fill" | "left" | "right" | "up" | "down" | null	DOCK_TYPE.FILL	-
width	number | null	null	-

Returns

TableView

---

addView()

addView(v, dockType?, width?, context?): ViewBase

Defined in: src/shell.ts:212

Adds a view.

Parameters

Parameter	Type	Default value
v	ViewBase	undefined
dockType	"fill" | "left" | "right" | "up" | "down"	DOCK_TYPE.FILL
width	number | null	null
context	FuncCall | null	null

Returns

ViewBase

---

clearDirtyFlag()

clearDirtyFlag(): void

Defined in: src/shell.ts:366

Clears dirty flag in scratchpad and open projects.

Returns

void

---

clearLastError()

clearLastError(): void

Defined in: src/shell.ts:111

Returns

void

---

closeAll()

closeAll(): void

Defined in: src/shell.ts:278

Closes everything (views, tables, projects) and returns the platform to the initial state.

Returns

void

---

closeTable()

closeTable(table): void

Defined in: src/shell.ts:102

Closes a table and removes from the workspace.

Parameters

Parameter	Type
table	DataFrame

Returns

void

---

dockElement()

dockElement(element, title?, dockStyle?, ratio?): void

Defined in: src/shell.ts:186

Docks element in a separate window. Sample: https://public.datagrok.ai/js/samples/ui/docking/docking

Parameters

Parameter	Type	Default value	Description
element	HTMLElement	undefined	-
title	string | null	null	-
dockStyle	"fill" | "left" | "right" | "up" | "down"	DOCK_TYPE.FILL	-
ratio	number	0.5	area to take (relative to parent)

Returns

void

---

error()

error(s, options?): void

Defined in: src/shell.ts:169

Shows information message (red background)

Parameters

Parameter	Type	Description
s	string | HTMLElement	message
options?	BalloonOptions	-

Returns

void

---

getTableView()

getTableView(tableName): TableView

Defined in: src/shell.ts:268

Returns TableView for the specified table if it exists, opens a new view if necessary. Search is case-insensitive.

Parameters

Parameter	Type	Description
tableName	string	-

Returns

TableView

---

getVar()

getVar(variableName): object

Defined in: src/shell.ts:348

Returns the value of the specified variable. Search is case-insensitive.

Parameters

Parameter	Type	Description
variableName	string	-

Returns

object

---

info()

info(x, options?): void

Defined in: src/shell.ts:161

Shows information message (green background)

Parameters

Parameter	Type	Description
x	any	message
options?	BalloonOptions	-

Returns

void

---

newView()

newView(name?, children?, options?): View

Defined in: src/shell.ts:234

Adds a new view with the specified name.

Parameters

Parameter	Type	Default value	Description
name	string	'view'	view name
children?	object[]	undefined	content to be added by calling ui.appendAll
options?	string | { } | null	undefined	-

Returns

View

---

openFileOpenDialog()

openFileOpenDialog(): void

Defined in: src/shell.ts:273

Opens a dialog for opening a file with tabular data (CSV, XSLS, etc)

Returns

void

---

registerViewer()

registerViewer(viewerTypeName, description, createViewer): void

Defined in: src/shell.ts:295

Registers a viewer. Sample: https://public.datagrok.ai/js/samples/scripts/functions/custom-viewers

Parameters

Parameter	Type	Description
viewerTypeName	string	-
description	string	-
createViewer	(...params) => JsViewer	a function that returns JsViewer

Returns

void

---

reportTest()

reportTest(type, params): Promise<void>

Defined in: src/shell.ts:49

Parameters

Parameter	Type
type	String
params	object

Returns

Promise<void>

---

route()

route(url): View

Defined in: src/shell.ts:192

Opens the view that handles the specified url. Sample: https://public.datagrok.ai/js/samples/ui/docking/docking

Parameters

Parameter	Type
url	string

Returns

View

---

setCurrentObject()

setCurrentObject(x, freeze, force?): void

Defined in: src/shell.ts:122

Parameters

Parameter	Type
x	any
freeze	boolean
force?	boolean

Returns

void

---

setVar()

setVar(variableName, variableValue): object

Defined in: src/shell.ts:355

Sets the value of the specified variable, and returns this value.

Parameters

Parameter	Type	Description
variableName	string	-
variableValue	object	-

Returns

object

---

table()

table(tableName): DataFrame

Defined in: src/shell.ts:300

Returns a DataFrame with the specified [tableName].

Parameters

Parameter	Type
tableName	string

Returns

DataFrame

---

tableByName()

tableByName(tableName): DataFrame

Defined in: src/shell.ts:341

Returns a table by its name. Search is case-insensitive.

Parameters

Parameter	Type	Description
tableName	string	-

Returns

DataFrame

---

tableView()

tableView(tableName): TableView

Defined in: src/shell.ts:311

Returns a first TableView for the specified [tableName], or null if there are no such views.

Parameters

Parameter	Type
tableName	string

Returns

TableView

---

testError()

testError(s): void

Defined in: src/shell.ts:45

Parameters

Parameter	Type
s	String

Returns

void

---

view()

view(name): View | null

Defined in: src/shell.ts:305

Returns a view with the specified [name], or null if there is no such view.

Parameters

Parameter	Type
name	string

Returns

View | null

---

warning()

warning(s, options?): void

Defined in: src/shell.ts:176

Shows warning message (yellow background)

Parameters

Parameter	Type	Description
s	string | HTMLElement	message
options?	BalloonOptions	-

Returns

void