Links

Built-in JavaScript functions

utils - utility functions

utils.openUrl()

Open a URL.
// Syntax
utils.openUrl( url: string, options?: { newTab: boolean = true } )
Parameter
Description
url
Required. A String value that specifies the URL to open. It must start with http:// or https://.
newTab
Optional. Boolean value that, when True, specifies the url is to open in a new tab. The default value is True.
// Example: Open google.com in a new tab.
utils.openUrl("https://www.google.com", { newTab: true })

utils.openApp()

Open an Openblocks app.
// Syntax
utils.openApp( applicationId: string, options?: { queryParams?: {"key":"value"}, hashParams?: {"key":"value"}, newTab: true } )
Parameter
Description
appId
Required. A String value that specifies the ID of the app to open.
queryParams: {'key1':'value1',key2:'value2',...}
Optional. An Object that specifies query parameters to pass into the app. The query parameters are added to the app URL in the form of ?key1=value1&key2=value2&...
hashParams:{'key1':'value1',key2:'value2',...}
Optional. An Object that specifies hash parameters to pass into the app. The hash parameters are added to the app URL in the form of #key1=value1&key2=value2&...
newTab
Optional. A Boolean value that, when True, specifies the url is to open in a new tab. The default value is True.
// Example: Open an Openblocks app in a new tab.
utils.openApp("632bddc33bb9722fb888f6c0", { newTab: true })
// Example: Open an Openblocks app and pass in "id" parameter.
utils.openApp("632bddc33bb9722fb888f6c0", {
queryParams: { "id": table1.selectedRow.id },
} )

utils.downloadFile()

Download a file containing the specified data.
// Syntax
utils.downloadFile(data: any, fileName: string, options?: {
fileType?: string,
dataType?: "url" | "base64"
} )
Parameter
Description
data
Required. A String or Object that specifies the data to download from queries, components, transformers, etc.
fileName
Required. A String value that specifies the name of the file to download.
fileType
Optional. A String value that specifies the type of the file to download. All MIME types are supported.
dataType
Optional. A String value that specifies the type of the data: "url" or "base64".
// Example: Download the base64 data from a file component as a PNG file named users-data.
utils.downloadFile(file1.value[0], "users-data", {
fileType: "png",
dataType: "base64",
})
// Example: Download the results of query1 as a XLXS file named users-data.
utils.downloadFile(query1.data, "users-data", { fileType: "xlsx" })
// or in this way:
utils.downloadFile(query1.data, "users-data.xlsx")
// Example: Download the results of query1 as a XLXS file named users-data.
utils.downloadFile(restApiQuery.data, "users-data", {
fileType: "pdf",
dataType: "base64",
})

utils.copyToClipboard()

Copy a string to clipboard.
// Syntax
utils.copyToClipboard( text: string )
Parameter
Description
text
Required. A String value that specifies the content to copy.
// Example: Copy the content of input component to clipboard.
utils.copyToClipboard( input1.value )

message - global notification

Use message methods to send a global alert notification, which displays at the top of the screen and lasts for 3 seconds by default. Each of the following four methods supports a unique display style.
// message.info( text: string, options?: {duration: number = 3 } )
message.info("Please confirm your information", { duration: 10 })
// message.success( text: string, options?: {duration: number = 3 } )
message.success("Query runs successfully", { duration: 10 })
// message.warn( text: string, options?: {duration: number = 3 } )
message.warn("Warning", { duration: 10 })
// message.error( text: string, options?: {duration: number = 3 } )
message.error("Query runs with error", { duration: 10 })

localStorage

Use localStorage methods to store and manage key-value pair data locally, which is not reset when the app refreshes, and can be accessed in any app within the workspace using localStorage.values.
Method
Description
setItem(key: string, value: any)
Store a key-value pair.
removeItem(key: string)
Delete a key-value pair.
clear()
Clear all data in localStorage.

localStorage.values

You can access any key-value pair in local storage using localStorage.values. in JavaScript queries.
Inspect the data in localStorage in Globals in the data browser.

localStorage.setItem()

Store a key-value pair.
// Syntax
localStorage.setItem(key: string, value: any)
// Example
localStorage.setItem("order", select1.value)

localStorage.removeItem()

Delete a key-value pair.
// Syntax
localStorage.removeItem(key: string)
// Example
localStorage.removeItem("order")

localStorage.clear()

Clear all data in localStorage.