Global

Type Definitions

AddClientToContextGroupOptions

AddClientToContextGroupOptions interface

Type:
  • object
Properties:
Name Type Description
contextGroupId string

Name of the context group.

addContextHandler(contextHandler, contextTypeopt) → {Promise.<void>}

A SessionContextGroup instance method for adding a handler for context change.

Parameters:
Name Type Attributes Description
contextHandler ContextHandler

The callback to be invoked. Is invoked when (a) the context changes or (b) immediately after getting created if the context is already set.

contextType string <optional>

The context type this handler should listen to. If not specified, a global handler for all context types will get created. Only one global handler is allowed per SessionContextGroup.

Returns:
Type
Promise.<void>

AppAssetInfo

AppAssetInfo interface

Type:
  • object
Properties:
Name Type Description
src string

The URL to a zip file containing the package files (executables, dlls, etc…)

alias string

The name of the asset

version string

The version of the package

target string

Specify default executable to launch. This option can be overridden in launchExternalProcess

args string

The default command line arguments for the aforementioned target.

mandatory boolean

When set to true, the app will fail to load if the asset cannot be downloaded. When set to false, the app will continue to load if the asset cannot be downloaded. (Default: true)

AppAssetRequest

AppAssetRequest interface

Type:
  • object
Properties:
Name Type Description
alias string

The name of the asset

AppIntent

An interface that represents the binding of an intent to apps.

Type:
  • object
Properties:
Name Type Description
intent Intent
apps Array.<AppMetadata>

ApplicationOptions

Application creation options.

This is the options object required by Application.start.

The following options are required:

  • uuid is required in the app manifest as well as by Application.start
  • name is optional in the app manifest but required by Application.start
  • url is optional in both the app manifest Application.start and but is usually given (defaults to "about:blank" when omitted).

This jsdoc typedef mirrors the ApplicationOption TypeScript interface in @types/openfin.

IMPORTANT NOTE: This object inherits all the properties of the window creation options object, which will take priority over those of the same name that may be provided in mainWindowOptions.

Type:
  • object
Properties:
Name Type Attributes Default Description
disableIabSecureLogging boolean <optional>
false

When set to true it will disable IAB secure logging for the app.

loadErrorMessage string <optional>
"There was an error loading the application."

An error message to display when the application (launched via manifest) fails to load. A dialog box will be launched with the error message just before the runtime exits. Load fails such as failed DNS resolutions or aborted connections as well as cancellations, e.g., window.stop(), will trigger this dialog. Client response codes such as 404 Not Found are not treated as fails as they are valid server responses.

mainWindowOptions Window~options <optional>

The options of the main window of the application. For a description of these options, click the link (in the Type column).

maxViewPoolSize number <optional>
1000

Platforms Only. The maximum number of "detached" or "pooled" Views that can exist in the Platform before being closed. If you do not wish for views to be pooled on your platform, set this property to zero.

preventQuitOnLastWindowClosed boolean <optional>
false

Platforms Only. Prevent the Platform Provider from quitting automatically when the last Platform Window is closed. Note: if the Platform Provider is showing, it won't close automatically. If you want a hidden Platform Provider to remain open after the last Platform Window has been closed, set this property to true.

name string <optional>

The name of the application (and the application's main window).

If provided, must match uuid.

nonPersistent boolean <optional>
false

A flag to configure the application as non-persistent. Runtime exits when there are no persistent apps running.

plugins boolean <optional>
false

Enable Flash at the application level.

spellCheck boolean <optional>
false

Enable spell check at the application level.

url string <optional>
"about:blank"

The url to the application (specifically the application's main window).

enableJumpList boolean <optional>
false

Enables the use of the Jumplists API and the 'pin to taskbar' functionality. Only relevant in Windows.

uuid string

The Unique Universal Identifier (UUID) of the application, unique within the set of all other applications running in the OpenFin Runtime.

Note that name and uuid must match.

webSecurity boolean <optional>
true

When set to false it will disable the same-origin policy for the app.

ApplicationState

ApplicationState interface

Type:
  • object
Properties:
Name Type Description
isPlatform boolean

true when the application is a Platform controller

isRunning boolean

true when the application is running

uuid string

uuid of the application

parentUuid string

uuid of the application that launches this application

ApplicationType

ApplicationType interface

Type:
  • object
Properties:
Name Type Description
type string

The type of the entity

uuid string

The uuid of the entity

ApplicationWindowInfo

ApplicationWindowInfo interface

Type:
  • object
Properties:
Name Type Description
childWindows Array.<WindowDetail>

The array of child windows details

mainWindow WindowDetail

The main window detail

uuid string

The uuid of the application

ApplySnapshotOptions

ApplySnapshotOptions interface

Type:
  • object
Properties:
Name Type Attributes Default Description
closeExistingWindows boolean <optional>
false

When true, applySnapshot will close existing windows, replacing current Platform state with the given snapshot.

closeSnapshotWindows boolean <optional>
false

When true, applySnapshot will close existing includeInSnapshots: true windows, replacing current Platform state with the given snapshot.

skipOutOfBoundsCheck boolean <optional>
false

When true, applySnapshot will not check whether any windows in a snapshot are off-screen. By default, such windows will be repositioned to be on-screen, as defined by PlatformProvider.positionOutOfBoundsWindows.

ApplySnapshotPayload

Payload sent to Platform Provider when Platform.applySnapshot is called.

Type:
  • object
Properties:
Name Type Attributes Description
snapshot Snapshot

The snapshot to be applied.

options ApplySnapshotOptions <optional>

Options to customize snapshot application.

AppMetadata

App metadata is provided by the FDC3 App Directory.

Type:
  • object
Properties:
Name Type Attributes Description
name string
appId string <optional>
version string <optional>
title string <optional>
tooltip string <optional>
description string <optional>
icons Array.<string> <optional>
images Array.<string> <optional>

AppProcessInfo

AppProcessInfo interface

Type:
  • object
Properties:
Name Type Description
uuid string

The uuid of the application

entities Array.<EntityProcessDetails>

Array of process info for each window and view for the application

Area

Type:
  • object
Properties:
Name Type Description
height number

Area's height

width number

Area's width

x number

X coordinate of area's starting point

y number

Y coordinate of area's starting point

BeforeUnloadUserDecision

Type:
  • object
Properties:
Name Type Description
windowShouldClose boolean

Specifies if the Window should close

viewsToClose Array.<Identity>

Array of views that will close

Bounds

Bounds is a interface that has the properties of height, width, left, top which are all numbers

Type:
  • object
Properties:
Name Type Description
height number

Get the application height bound

width number

Get the application width bound

top number

Get the application top bound

left number

Get the application left bound

right number

Get the application right bound

bottom number

Get the application bottom bound

CapturePageOptions

Type:
  • object
Properties:
Name Type Attributes Default Description
area Area <optional>

The area of the window to be captured.

format string <optional>
'png'

The format of the captured image. Can be 'png', 'jpg', or 'bmp'.

quality number <optional>
100

Number representing quality of JPEG image only. Between 0 - 100.

CertifiedAppInfo

CertifiedAppInfo interface

Type:
  • object
Properties:
Name Type Attributes Description
isRunning boolean

true if the app is running

isOptedIntoCertfiedApp boolean <optional>

true if the app has opted into certification

isCertified boolean <optional>

true if the app is certified

isSSLCertified boolean <optional>

true if the app manifest's SSL certificate is valid

isPresentInAppDirectory boolean <optional>

true if the app is present in the OpenFin app directory

Channel

Information for a Context Group. Contains metadata for displaying the group properly.

Type:
  • object
Properties:
Name Type Description
id string

Name of the context group

displayMetadata DisplayMetadata

Metadata for the Context Group. Contains the group's human-readable name, color, and an image, as defined by the Interop Broker.

type string

Defaults to system.

broadcast function

Broadcasts a context for the channel.

addContextListener function

Add a context handler for incoming context.

getCurrentContext function

Gets the current context for the channel.

ClearCacheOption

Clear cache options.

These are the options required by the clearCache function.

Type:
  • object
Properties:
Name Type Description
appcache boolean

html5 application cache

cache boolean

browser data cache for html files and images

cookies boolean

browser cookies

localStorage boolean

browser data that can be used across sessions

ClientIdentity

The Identity for a Channel Client. Includes endpointId to differentiate between different connections for an entity.

Type:
  • object
Properties:
Name Type Description
uuid string

GUID of an application.

name string

Name of an entity in an application.

endpointId string

Unique differentiator for different Channel connections for an entity.

CloseViewPayload

CloseViewPayload interface

Type:
  • object
Properties:
Name Type Description
target Identity

View to be closed.

CloseWindowOptions

closeWindow options

Type:
  • object
Properties:
Name Type Attributes Default Description
skipBeforeUnload boolean <optional>
false

When set to true skips any before handler set on views that are part of the window

CloseWindowPayload

Type:
  • object
Properties:
Name Type Description
winId Identity

Identity of the Window

options CloseWindowOptions

ContentCreationRule

ContentCreationRule interface

Type:
  • object
Properties:
Name Type Description
behavior string

'view' | 'window' | 'browser' | 'block'

match Array.<string>

List of match patterns.

options object

Window creation options or View creation options.

Context

Data passed between entities and applications.

Type:
  • object
Properties:
Name Type Attributes Description
id object <optional>

An object containing string key-value pairs for the bulk of the data for the context. Differs between context types.

name string <optional>

User-readable name for the incoming context.

type string

Conserved type for the context (e.g. instrument or country)

ContextForIntent

Data passed between entities and applications, including an optional metadata.

Type:
  • object
Properties:
Name Type Attributes Description
id object <optional>

An object containing string key-value pairs for the bulk of the data for the context. Differs between context types.

name string <optional>

User-readable name for the incoming context.

type string

Conserved type for the context (e.g. instrument or country)

metadata any <optional>

ContextGroupInfo

Information for a Context Group. Contains metadata for displaying the group properly.

Type:
  • object
Properties:
Name Type Description
id string

Name of the context group

displayMetadata DisplayMetadata

Metadata for the Context Group. Contains the group's human-readable name, color, and an image, as defined by the Interop Broker.

ContextHandler()

Subscription function for addContextHandler.

CookieInfo

CookieInfo interface

Type:
  • object
Properties:
Name Type Description
name string

The name of the cookie

domain string

The domain of the cookie

path string

The path of the cookie

CookieOption

CookieOption interface

Type:
  • object
Properties:
Name Type Description
name string

The name of the cookie

CpuInfo

CpuInfo interface

Type:
  • object
Properties:
Name Type Description
model string

The model of the cpu

speed number

The number in MHz

times Time

The numbers of milliseconds the CPU has spent in different modes.

CrashReporterOptions

CrashReporterOptions interface

Type:
  • object
Properties:
Name Type Description
diagnosticsMode boolean

In diagnostics mode the crash reporter will send diagnostic logs to the OpenFin reporting service on runtime shutdown

CrashReporterState

CrashReporterState interface

Type:
  • object
Properties:
Name Type Description
diagnosticsMode boolean

In diagnostics mode the crash reporter will send diagnostic logs to the OpenFin reporting service on runtime shutdown

isRunning boolean

check if it's running

CreateViewPayload

CreateViewPayload interface

Type:
  • object
Properties:
Name Type Attributes Description
opts View~options

Options for the view to be added.

target Identity <optional>

Window the view will be added to. If no target is provided, a new window will be created.

DefaultWindowOptions

Default window options apply to all platform windows. Any Window option is also a valid Default Window option used by default in any window that is created in the current platform's scope. Individual window options will override these defaults.

Type:
  • object
Properties:
Name Type Attributes Description
stylesheetUrl string <optional>

Specify a path of a custom CSS file to be injected to all of the platform's windows. note: this option is only applied to windows that use the Default OpenFin Window. Windows with a specified url (Custom Windows) will not be affected by this option.

DipRect

DipRect interface

Type:
  • object
Properties:
Name Type Description
dipRect Rect

The DIP coordinates

scaledRect Rect

The scale coordinates

DipScaleRects

DipScaleRects interface

Type:
  • object
Properties:
Name Type Description
dipRect Rect

The DIP coordinates

scaledRect Rect

The scale coordinates

DisplayMetadata

The display data for a Context Group.

Type:
  • object
Properties:
Name Type Attributes Description
name string

A user-readable name for this context group, e.g: "Red"

color string <optional>

The color that should be associated within this context group when displaying this context group in a UI, e.g: 0xFF0000.

glyph string <optional>

A URL of an image that can be used to display this context group

DownloadPreloadInfo

downloadPreloadScripts function return value

Type:
  • object
Properties:
Name Type Description
url string

url to the preload script

error string

error during preload script acquisition

succeess boolean

download operation success

DownloadPreloadOption

These are the options object required by the downloadPreloadScripts function

Type:
  • object
Properties:
Name Type Description
url string

url to the preload script

Dpi

Type:
  • object
Properties:
Name Type Attributes Description
horizontal number <optional>

The horizontal dpi

vertical number <optional>

The vertical dpi

EntityInfo

EntityInfo interface

Type:
  • object
Properties:
Name Type Description
name string

The name of the entity

uuid string

The uuid of the entity

parent Identity

The parent of the entity

entityType string

The type of the entity

EntityProcessDetails

EntityProcessDetails interface

Type:
  • object
Properties:
Name Type Description
uuid string

The uuid for the entity

name string

The name for the entity

url string

URL associated with the entity

entityType string

Type for the entity: window or view

cpuUsage number

The percentage of total CPU usage

nonPagedPoolUsage number

The current nonpaged pool usage in bytes

pageFaultCount number

The number of page faults

pagedPoolUsage number

The current paged pool usage in bytes

pagefileUsage number

The total amount of memory in bytes that the memory manager has committed

peakNonPagedPoolUsage number

The peak nonpaged pool usage in bytes

peakPagedPoolUsage number

The peak paged pool usage in bytes

peakPagefileUsage number

The peak value in bytes of pagefileUsage during the lifetime of this process

peakWorkingSetSize number

The peak working set size in bytes

privateSetSize number

The current working set size (not shared)

workingSetSize number

The current working set size (both shared and private data) in bytes

pid number

The native process identifier

frames Array.<FrameProcessDetails>

Array of process info for each iframe corresponeding to the entity

ExternalApplicationInfo

ExternalApplicationInfo interface

Type:
  • object
Properties:
Name Type Description
parent Identity

The parent identity

ExternalConnection

ExternalConnection interface

Type:
  • object
Properties:
Name Type Description
token string

The token to broker an external connection

uuid string

The uuid of the external connection

ExternalProcessRequestType

ExternalProcessRequestType interface

Type:
  • object
Properties:
Name Type Description
path string

The file path to where the running application resides

arguments string

The argument passed to the running application

listener LaunchExternalProcessListener

This is described in the {LaunchExternalProcessListner} type definition

initialWindowState string

Initial window state after launching: 'normal' (default), 'minimized', 'maximized'

cwd string

current working directory

FetchManifestPayload

FetchManifestPayload interface

Type:
  • object
Properties:
Name Type Description
manifestUrl string

The URL of the manifest to fetch.

FindInPageOptions

Type:
  • object
Properties:
Name Type Attributes Default Description
forward boolean <optional>
true

Whether to search forward or backward.

findNext boolean <optional>
false

Whether to begin a new text finding session. Should be true for first requests, and false for subsequent requests. Defaults to false.

matchCase boolean <optional>
false

Whether search should be case-sensitive.

wordStart boolean <optional>
false

Whether to look only at the start of words.

medialCapitalAsWordStart boolean <optional>
false

When combined with wordStart, accepts a match in the middle of a word if the match begins with an uppercase letter followed by a
lowercase or non-letter. Accepts several other intra-word matches.

FrameInfo

FrameInfo interface

Type:
  • object
Properties:
Name Type Description
name string

The name of the frame

uuid string

The uuid of the frame

entityType EntityType

The entity type, could be 'window', 'iframe', 'external connection' or 'unknown'

parent Identity

The parent identity

FrameProcessDetails

FrameProcessDetails interface

Type:
  • object
Properties:
Name Type Description
url string

Current URL associated with the process

entityType string

Type for the frame

cpuUsage number

The percentage of total CPU usage

nonPagedPoolUsage number

The current nonpaged pool usage in bytes

pageFaultCount number

The number of page faults

pagedPoolUsage number

The current paged pool usage in bytes

pagefileUsage number

The total amount of memory in bytes that the memory manager has committed

peakNonPagedPoolUsage number

The peak nonpaged pool usage in bytes

peakPagedPoolUsage number

The peak paged pool usage in bytes

peakPagefileUsage number

The peak value in bytes of pagefileUsage during the lifetime of this process

peakWorkingSetSize number

The peak working set size in bytes

workingSetSize number

The current working set size (both shared and private data) in bytes

pid number

The native process identifier

GetAllClientsInContextGroupOptions

GetAllClientsInContextGroupOptions interface

Type:
  • object
Properties:
Name Type Description
contextGroupId string

Name of the context group to get info for.

GetContextOptions

GetContextOptions interface

Type:
  • object
Properties:
Name Type Attributes Description
contextType string <optional>

Context Type

getCurrentContext(contextTypeopt) → {Promise.<Context>}

A SessionContextGroup instance method for getting the current context of a certain type.

Parameters:
Name Type Attributes Description
contextType string <optional>

The Context Type to get. If not specified the last contextType set would get used.

Returns:
Type
Promise.<Context>

GetInfoForContextGroupOptions

GetInfoForContextGroupOptions interface

Type:
  • object
Properties:
Name Type Description
contextGroupId string

Name of the context group to get info for.

GetLogRequestType

GetLogRequestType interface

Type:
  • object
Properties:
Name Type Description
name string

The name of the running application

endFile number

The file length of the log file

sizeLimit number

The set size limit of the log file

GetWindowContextPayload

GetWindowContextPayload interface

Type:
  • object
Properties:
Name Type Description
entityType EntityType

Entity type of the target of the context update ('view' or 'window').

target Identity

Identity of the entity targeted by the call to Platform.getWindowContext.

GpuInfo

GpuInfo interface

Type:
  • object
Properties:
Name Type Description
name string

The graphics card name

HostContextChangedPayload

HostContextChangedPayload interface

Type:
  • object
Properties:
Name Type Description
context any

The new context object

reason string

The reason for the update: 'updated' or 'reparented'

HostSpecs

HostSpecs interface

Type:
  • object
Properties:
Name Type Description
aeroGlassEnabled boolean

Value to check if Aero Glass theme is supported on Windows platforms

arch string

"x86" for 32-bit or "x86_64" for 64-bit

cpus Array.<CpuInfo>

The same payload as Node's os.cpus()

gpu GpuInfo

The graphics card name

memory number

The same payload as Node's os.totalmem()

name string

The OS name and version/edition

screenSaver boolean

Value to check if screensaver is running. Supported on Windows only

Identity

Identity interface

Type:
  • object
Properties:
Name Type Description
name string

Optional - the name of the component

uuid string

Universally unique identifier of the application

ImplementationMetadata

An interface that represents FDC3 implementation meta data.

Type:
  • object
Properties:
Name Type Attributes Description
fdc3Version string

The FDC3 version

provider string

The provider uuid with prepend 'openfin'

providerVersion string <optional>

The provider runtime version

InfoForIntentOptions

InfoForIntentOptions interface

Type:
  • object
Properties:
Name Type Attributes Description
name string

Name of the intent to get info for.

context Context <optional>

Optional context.

InitLayoutOptions

InitLayoutOptions interface

Type:
  • object
Properties:
Name Type Attributes Description
containerId string <optional>

The id attribute of the container where the window's Layout should be initialized. If not provided then an element with id layout-container is used. We recommend using a div element.

InitPlatformOptions

InitPlatformOptions interface

Type:
  • object
Properties:
Name Type Attributes Description
overrideCallback OverrideCallback <optional>

a callback function that can be used to extend or replace default Provider behavior.

Intent

The combination of an action and a context that is passed to an application for resolution.

Type:
  • object
Properties:
Name Type Description
name string

Name of the intent.

context Context

Data associated with the intent

IntentHandler()

Subscription function for registerIntentHandler

IntentResolution

IntentResolution provides a standard format for data returned upon resolving an Intent.

Type:
  • object
Properties:
Name Type Attributes Description
source TargetApp

identifier for the Application resolving the Intent (null if the Intent could not be resolved)

data string <optional>

Return data structure - if one is provided for the given Intent.

version string

The version number of the Intents schema being used

InteropConfig

Information relevant to the Interop Broker.

Type:
  • object
Properties:
Name Type Attributes Description
currentContextGroup string <optional>

Context Group for the client. (green, yellow, red, etc.)

providerId string <optional>

When provided, automatically connects the client to the specified provider uuid

JoinContextGroupOptions

JoinContextGroupOptions interface

Type:
  • object
Properties:
Name Type Attributes Description
contextGroupId string

Id of the context group.

target Identity | ClientIdentity <optional>

Identity of the entity you wish to join to a context group.

JumpListCategory

JumpListCategory interface

Type:
  • object
Properties:
Name Type Description
name string

The display title for the category. If omitted, items in this category will be placed into the standard 'Tasks' category. There can be only one such category, and it will always be displayed at the bottom of the JumpList.

items Array.<JumpListItem>

Array of JumpListItem objects

JumpListItem

JumpListItem interface

Type:
  • object
Properties:
Name Type Description
type string

One of the following: "task" or "separator". Defaults to task.

title string

The text to be displayed for the JumpList Item. Should only be set if type is "task".

description string

Description of the task (displayed in a tooltip). Should only be set if type is "task".

deepLink string

Deep link to a manifest, i.e: fins://path.to/manifest.json?$$param1=value1. See deep-linking for more information.

iconPath string

The absolute path to an icon to be displayed for the item, which can be an arbitrary resource file that contains an icon (e.g. .ico, .exe, .dll).

iconIndex number

The index of the icon in the resource file. If a resource file contains multiple icons this value can be used to specify the zero-based index of the icon that should be displayed for this task. If a resource file contains only one icon, this property should be set to zero.

LayoutConfig

LayoutConfig interface

Type:
  • object
Properties:
Name Type Description
content Array.<LayoutItem>

Content of the layout. There can only be one top-level LayoutItem in the content array. We do not recommend trying to build Layouts or LayoutItems by hand and instead use calls such as getSnapshot or our Layout Config Generation Tool .

settings LayoutSettings

Configuration for certain Layout behaviors. See the LayoutSettings interface.

LayoutItem

LayoutItem Interface

Type:
  • object
Properties:
Name Type Attributes Description
type string

The type of the item. Possible values are 'row', 'column', 'stack', and 'component'.

content Array.<LayoutItem> <optional>

An array of configurations for items that will be created as children of this item.

componentName string <optional>

Only a component type will have this property and it should be set to view.

componentState View~options <optional>

Only a component type will have this property and it represents the view options of a given component.

LayoutSettings

LayoutSettings Interface

Type:
  • object
Properties:
Name Type Attributes Default Description
constrainDragToHeaders boolean <optional>
false

Limits the area to which tabs can be dragged. If true, stack headers are the only areas where tabs can be dropped.

hasHeaders boolean <optional>
true

Turns tab headers on or off. If false, the layout will be displayed with splitters only.

newTabButton object <optional>

Configuration of the Plus button that appears on each tabstrip. Upon pressing, a new tab will be added to the tabstrip with the specified url.

Properties
Name Type Attributes Description
url string <optional>

Specifies the url that opens in the tab created upon pressing the button.

popoutWholeStack boolean <optional>
false

Whether the popout button will only act on the entire stack, as opposed to only the active tab.

preventDragIn boolean <optional>
false

If true, tabs can't be dragged into the window.

preventDragOut boolean <optional>
false

If true, tabs can't be dragged out of the window.

preventSplitterResize boolean <optional>
false

If true, tab contents can't be resized by the user.

reorderEnabled boolean <optional>
true

If true, the user can re-arrange the layout by dragging items by their tabs to the desired location.

showCloseIcon boolean <optional>
false

Whether to show the close button on stack header (not to be confused with close button on every tab).

showMaximiseIcon boolean <optional>
false

Whether to show the maximize button on stack header. The button will maximize the current tab to fill the entire window.

showPopoutIcon boolean <optional>
false

Whether to show the popout button on stack header. The button will create a new window with current tab as its content. In case popoutWholeStack is set to true, all tabs in the stack will be in the new window.

Listener

Listener object returned by addContextListener and addIntentListener

Type:
  • object
Properties:
Name Type Description
unsubscribe function

function for addContextListener and addIntentListener.

LogInfo

LogInfo interface

Type:
  • object
Properties:
Name Type Description
name string

The filename of the log

size number

The size of the log in bytes

date string

The unix time at which the log was created "Thu Jan 08 2015 14:40:30 GMT-0500 (Eastern Standard Time)"

LogLevel

Log verbosity levels.

Describes the minimum level (inclusive) above which logs will be written

Type:
  • verbose | info | warning | error | fatal
Properties:
Name Type Description
verbose string

all logs written

info string

info and above

warning string

warning and above

error string

error and above

fatal string

fatal only, indicates a crash is imminent

ManifestInfo

ManifestInfo interface

Type:
  • object
Properties:
Name Type Description
uuid string

The uuid of the application

manifestUrl string

The runtime manifest URL

Margins

Type:
  • object
Properties:
Name Type Attributes Description
marginType string <optional>

Can be default, none, printableArea, or custom. If custom is chosen, you will also need to specify top, bottom, left, and right.

top number <optional>

The top margin of the printed web page, in pixels.

bottom number <optional>

The bottom margin of the printed web page, in pixels.

left number <optional>

The left margin of the printed web page, in pixels.

right number <optional>

The right margin of the printed web page, in pixels.

Type:
  • object
Properties:
Name Type Attributes Description
data *

Data to be returned if the user selects the element. Must be serializable. Large objects can have a performance impact.

type 'normal' | 'separator' | 'submenu' | 'checkbox' <optional>

Defaults to 'normal' unless a 'submenu' key exists

label string <optional>

The text to show on the menu item. Should be left undefined for type: 'separator'

enabled boolean <optional>

If false, the menu item will be greyed out and unclickable.

visible boolean <optional>

If false, the menu item will be entirely hidden.

checked boolean <optional>

Should only be specified for checkbox type menu items.

submenu Array.<MenuItemTemplate> <optional>

Should be specified for submenu type menu items. If submenu is specified, the type: 'submenu' can be omitted.

Type:
  • object
Properties:
Name Type Attributes Description
result 'clicked' | 'closed'

Whether the user clicked on a menu item or the menu was closed (user clicked elsewhere).

data * | undefined <optional>

The data property of the menu item clicked by the user. Only defined if result was clicked.

MonitorDetails

MonitorDetails interface

Type:
  • object
Properties:
Name Type Description
available DipScaleRects

The available DIP scale coordinates

availableRect Rect

The available monitor coordinates

deviceId string

The device id of the display

displayDeviceActive boolean

true if the display is active

deviceScaleFactor number

The device scale factor

monitorRect Rect

The monitor coordinates

name string

The name of the display

dpi Point

The dots per inch

monitor DipScaleRects

The monitor coordinates

MonitorInfo

MonitorInfo interface

Type:
  • object
Properties:
Name Type Description
deviceScaleFactor number

The device scale factor

dpi Point

The dots per inch

nonPrimaryMonitors Array.<MonitorDetails>

The array of monitor details

primaryMonitor MonitorDetails

The monitor details

reason string

always "api-query"

taskBar TaskBar

The taskbar on monitor

virtualScreen DipRect

The virtual display screen coordinates

Opacity

Type:
  • object
Properties:
Name Type Description
duration number

The total time in milliseconds this transition should take.

relative boolean

Treat 'opacity' as absolute or as a delta. Defaults to false.

opacity number

This value is clamped from 0.0 to 1.0.

PlatformOptions

The options object required by Platform.start Any Application option is also a valid platform option

Type:
  • object
Properties:
Name Type Attributes Description
commands Array.<Object> <optional>

Configuration for keyboard commands. For details and usage, see Using Keyboard Commands.

defaultWindowOptions DefaultWindowOptions <optional>

Default window options apply to all platform windows.

defaultViewOptions View~options <optional>

Default view options apply to all platform views.

viewProcessAffinityStrategy ProcessAffinityStrategy <optional>

'same' | 'different'.

Point

Point interface

Type:
  • object
Properties:
Name Type Description
x number

The mouse x position

y number

The mouse y position

PointTopLeft

PointTopLeft interface

Type:
  • object
Properties:
Name Type Description
top number

The mouse top position in virtual screen coordinates

left number

The mouse left position in virtual screen coordinates

PopupOptions

Type:
  • object
Properties:
Name Type Attributes Description
name string <optional>

If a window with this name exists, it will be shown as a popup. Otherwise, a new window with this name will be created. If this name is undefined, initialOptions.name will be used. If this name and intialOptions.name are both undefined, a name will be generated.

url string <optional>

Navigates to this url if showing an existing window as a popup, otherwise the newly created window will load this url.

initialOptions Window~options <optional>

Window creation options when using showPopupWindow to create a new window.

additionalOptions Window~options <optional>

Updatable window options applied to new and existing windows when shown as popups.

onPopupResult function <optional>

Executed when this window's popup calls dispatchPopupResult. Note: if this is defined, showPopupWindow will not return a PopupResult.

onPopupReady function <optional>

Executed when the popup window is shown. Provides the popup window to the provided function, and allows for easy access the popup window for additional behavior customization.

height number <optional>

Height of the popup window (takes priority over intialOptions size properties).

width number <optional>

Width of the popup window (takes priority over intialOptions size properties).

x number <optional>

Left position where the popup window will be shown (relative to the window calling showPopupWindow).

y number <optional>

Top position where the popup window will be shown (relative to the window calling showPopupWindow).

blurBehavior 'modal' | 'hide' | 'close' <optional>

Determines what happens if the popup window is blurred. 'modal' restricts resizing and positioning in the caller, 'hide' hides the popup window on blur and 'close' closes the popup window on blur.

resultDispatchBehavior 'none' | 'hide' | 'close' <optional>

Determines what happens when the popup window calls dispatchPopupResult. 'none' will do nothing, 'hide' hides the popup window on dispatchPopupResult and 'close' closes the popup window on dispatchPopupResult.

focus boolean <optional>

Determines if the popup window should or should not be focused when it is shown.

hideOnClose boolean <optional>

Hide the popup window instead of closing whenever close is called on it. Note: if this is true and blurBehavior and/or resultDispatchBehavior are set to close, the window will be hidden.

PopupResult

Type:
  • object
Properties:
Name Type Attributes Description
identity Identity

name and uuid of the popup window that called dispatched this result.

result 'clicked' | 'dismissed'

Result of the user interaction with the popup window.

data * | undefined <optional>

Data passed to dispatchPopupResult.

Position

Type:
  • object
Properties:
Name Type Description
duration number

The total time in milliseconds this transition should take.

relative boolean

Treat 'opacity' as absolute or as a delta. Defaults to false.

left number

Defaults to the window's current left position in virtual screen coordinates.

top number

Defaults to the window's current top position in virtual screen coordinates.

PresetLayoutOptions

PresetLayoutOptions interface

Type:
  • object
Properties:
Name Type Description
presetType LayoutPresetTypes

Which preset layout arrangement to use. The preset options are columns, grid, rows, and tabs.

PrinterInfo

PrinterInfo interface

Type:
  • object
Properties:
Name Type Description
name string

Printer Name

description string

Printer Description

status number

Printer Status

isDefault boolean

Indicates that system's default printer

PrintOptions

Type:
  • object
Properties:
Name Type Attributes Default Description
silent boolean <optional>
false

Don't ask user for print settings.

printBackground boolean <optional>
false

Prints the background color and image of the web page.

deviceName string <optional>
''

Set the printer device name to use.

color boolean <optional>
true

Set whether the printed web page will be in color or grayscale.

margins Margins <optional>

Set margins for the printed web page

landscape boolean <optional>
false

Whether the web page should be printed in landscape mode.

scaleFactor number <optional>

The scale factor of the web page.

pagesPerSheet number <optional>

The number of pages to print per page sheet.

collate boolean <optional>

Whether the web page should be collated.

copies number <optional>

The number of copies of the web page to print.

pageRanges Record.<string, number> <optional>

The page range to print. Should have two keys: from and to.

duplexMode string <optional>

Set the duplex mode of the printed web page. Can be simplex, shortEdge, or longEdge.

dpi Dpi <optional>

Set dpi for the printed web page

ProcessAffinityStrategy

Strategy to place views that share a domain into different process affinities or the same process affinity.

Type:
  • same | different
Properties:
Name Type Description
same string

views in the same domain will have the same process affinity.

different string

views in the same domain will have different process affinities.

ProcessDetails

ProcessDetails interface

Type:
  • object
Properties:
Name Type Description
cpuUsage number

The percentage of total CPU usage

nonPagedPoolUsage number

The current nonpaged pool usage in bytes

pageFaultCount number

The number of page faults

pagedPoolUsage number

The current paged pool usage in bytes

pagefileUsage number

The total amount of memory in bytes that the memory manager has committed

peakNonPagedPoolUsage number

The peak nonpaged pool usage in bytes

peakPagedPoolUsage number

The peak paged pool usage in bytes

peakPagefileUsage number

The peak value in bytes of pagefileUsage during the lifetime of this process

peakWorkingSetSize number

The peak working set size in bytes

workingSetSize number

The current working set size (both shared and private data) in bytes

pid number

The native process identifier

ProcessInfo

ProcessInfo interface

Type:
  • object
Properties:
Name Type Description
cpuUsage number

The percentage of total CPU usage

name string

The application name

nonPagedPoolUsage number

The current nonpaged pool usage in bytes

pageFaultCount number

The number of page faults

pagedPoolUsage number

The current paged pool usage in bytes

pagefileUsage number

The total amount of memory in bytes that the memory manager has committed

peakNonPagedPoolUsage number

The peak nonpaged pool usage in bytes

peakPagedPoolUsage number

The peak paged pool usage in bytes

peakPagefileUsage number

The peak value in bytes of pagefileUsage during the lifetime of this process

peakWorkingSetSize number

The peak working set size in bytes

processId number

The native process identifier

uuid string

The application UUID

workingSetSize number

The current working set size (both shared and private data) in bytes

ProxyConfig

ProxyConfig interface

Type:
  • object
Properties:
Name Type Description
proxyAddress string

The configured proxy address

proxyPort number

The configured proxy port

type string

The proxy Type

ProxyInfo

ProxyInfo interface

Type:
  • object
Properties:
Name Type Description
config ProxyConfig

The proxy config

system ProxySystemInfo

The proxy system info

ProxySystemInfo

ProxySystemInfo interface

Type:
  • object
Properties:
Name Type Description
autoConfigUrl string

The auto configuration url

bypass string

The proxy bypass info

enabled boolean

Value to check if a proxy is enabled

proxy string

The proxy info

QueryPermissionResult

QueryPermissionResult interface

Type:
  • object
Properties:
Name Type Attributes Description
permission string

The full name of a secured API

state string

'granted' | 'denied' | 'unavailable'

granted boolean

true if permission is granted

rawValue object <optional>

The value of permission

Rect

Rect interface

Type:
  • object
Properties:
Name Type Description
bottom number

The bottom-most coordinate

left number

The left-most coordinate

right number

The right-most coordinate

top number

The top-most coordinate

RegistryInfo

RegistryInfo interface

Type:
  • object
Properties:
Name Type Description
data any

The registry data

rootKey string

The registry root key

subkey string

The registry key

type string

The registry type

value string

The registry value name

RemoveFromContextGroupOptions

RemoveFromContextGroupOptions interface

Type:
  • object
Properties:
Name Type Description
target Identity | ClientIdentity

Identity of the entity you wish to join to a context group.

ReplaceLayoutOpts

ReplaceLayoutOpts interface

Type:
  • object
Properties:
Name Type Description
layout LayoutConfig

Layout config to be applied.

ReplaceLayoutPayload

ReplaceLayoutPayload interface

Type:
  • object
Properties:
Name Type Description
opts ReplaceLayoutOpts

Object containing the layout to be applied.

target Identity

Identity of the window whose layout will be replace.

RuntimeDownloadOptions

These are the options object required by the downloadRuntime function.

Type:
  • object
Properties:
Name Type Description
version string

The given version to download

RuntimeInfo

RuntimeInfo interface

Type:
  • object
Properties:
Name Type Description
architecture string

The runtime build architecture

manifestUrl string

The runtime manifest URL

port number

The runtime websocket port

securityRealm string

The runtime security realm

version string

The runtime version

args object

the command line argument used to start the Runtime

chromeVersion string

The chrome version

electronVersion string

The electron version

RVMInfo

RVMInfo interface

Type:
  • object
Properties:
Name Type Description
action string

The name of action: "get-rvm-info"

appLogDirectory string

The app log directory

path string

The path of OpenfinRVM.exe

'start-time' string

The start time of RVM

version string

The version of RVM

'working-dir' string

The working directory

RvmLaunchOptions

RvmLaunchOptions interface

Type:
  • object
Properties:
Name Type Attributes Description
noUi boolean <optional>

true if no UI when launching

userAppConfigArgs object <optional>

The user app configuration args

timeToLive number <optional>

Timeout in seconds until RVM launch request expires

ServiceConfiguration

ServiceConfiguration interface

Type:
  • object
Properties:
Name Type Description
config object

The service configuration

name string

The name of the service

ServiceIdentifier

ServiceIdentifier interface

Type:
  • object
Properties:
Name Type Description
name string

The name of the service

SessionContextGroup

An instance of a SessionContextGroup

Type:
  • object
Properties:
Name Type Description
id string

The SessionContextGroup's id.

setContext setContext

Sets a context of a certain type

getCurrentContext getCurrentContext

Gets the currently set context of a certain type

addContextHandler addContextHandler

Adds a handler for context change.

setContext(context) → {Promise.<void>}

A SessionContextGroup instance method for setting a context in the SessionContextGroup.

Parameters:
Name Type Description
context Context

The Context to be set.

Returns:
Type
Promise.<void>

SetContextOptions

SetContextOptions interface

Type:
  • object
Properties:
Name Type Description
{context} Context

New context to set.

SetWindowContextPayload

SetWindowContextPayload interface

Type:
  • object
Properties:
Name Type Description
context any

The requested context update.

entityType EntityType

Entity type of the target of the context update ('view' or 'window').

target Identity

Identity of the entity targeted by the call to Platform.setWindowContext.

SetWindowContextPayload

SetWindowContextPayload interface

Type:
  • object
Properties:
Name Type Description
context any

The requested context update.

entityType EntityType

Entity type of the target of the context update ('view' or 'window').

target Identity

Identity of the entity targetted by the call to Platform.setWindowContext.

SharedWorkerInfo

SharedWorkerInfo interface

Type:
  • object
Properties:
Name Type Description
id string

The unique id of the shared worker.

url string

The url of the shared worker.

ShortCutConfig

ShortCutConfig interface

Type:
  • object
Properties:
Name Type Description
desktop boolean

true if application has a shortcut on the desktop

startMenu boolean

true if application has shortcut in the start menu

systemStartup boolean

true if application will be launched on system startup

ShowPopupMenuOptions

Type:
  • object
Properties:
Name Type Attributes Description
template Array.<MenuItemTemplate>

An array describing the menu to show.

x number <optional>

The window x coordinate where to show the menu. Defaults to mouse position. If using must also use y.

y number <optional>

The window y coordinate where to show the menu. Defaults to mouse position. If using must also use x

ShowViewsOnSplitterDrag

Platform Windows Only. Allows views to be shown when they are resized by the user dragging the splitter between layout stacks.

Type:
  • Object
Properties:
Name Type Attributes Default Description
enabled boolean <optional>
false

Enables or disables showing views when the layout splitter is being dragged.

ShowViewsOnTabDrag

Platform Windows Only. Allows views to be shown when the user is manipulating the layout by repositioning a tab.

Type:
  • Object
Properties:
Name Type Attributes Default Description
enabled boolean <optional>
false

Enables or disables showing views when a tab is being dragged.

ShowViewsOnWindowResize

Platform Windows Only. Enables views to be shown when a Platform Window is being resized by the user.

Type:
  • Object
Properties:
Name Type Attributes Default Description
enabled boolean <optional>
false

Enables or disables showing Views when a Platform Window is being resized.

paintIntervalMs number <optional>
0

Number of miliseconds to wait between view repaints.

Size

Type:
  • object
Properties:
Name Type Description
duration number

The total time in milliseconds this transition should take.

relative boolean

Treat 'opacity' as absolute or as a delta. Defaults to false.

width number

Optional if height is present. Defaults to the window's current width.

height number

Optional if width is present. Defaults to the window's current height.

Snapshot

Snapshot interface

Type:
  • object
Properties:
Name Type Description
windows Array.<WindowOption>

The array of window options objects

SnapshotProvider

Type:
  • object
Properties:
Name Type Attributes Description
getSnapshot getSnapshot <optional>
applySnapshot applySnapshot <optional>

SubOptions

SubOptions interface

Type:
  • Object
Properties:
Name Type Description
timestamp number

The event timestamp

Subscription

Object returned when subscribing a handler.

Type:
  • object
Properties:
Name Type Description
unsubscribe function

Function to unsubscribe the handler.

SystemProcessInfo

SystemProcessInfo interface

Type:
  • object
Properties:
Name Type Description
browserProcess ProcessDetails

Info on browser process

apps Array.<AppProcessInfo>

Array of apps and their process info

TargetApp

Some operations can identify an app just by its name, or pass full app metadata.

Type:

TaskBar

TaskBar interface

Type:
  • object
Properties:
Name Type Description
edge string

which edge of a monitor the taskbar is on

rect Rect

The taskbar coordinates

TerminateExternalRequestType

TerminateExternalRequestType interface

Type:
  • object
Properties:
Name Type Description
uuid string

The uuid of the running application

timeout number

Time out period before the running application terminates

killtree boolean

Value to terminate the running application

Time

Time interface

Type:
  • object
Properties:
Name Type Description
user number

The number of milliseconds the CPU has spent in user mode

nice number

The number of milliseconds the CPU has spent in nice mode

sys number

The number of milliseconds the CPU has spent in sys mode

idle number

The number of milliseconds the CPU has spent in idle mode

irq number

The number of milliseconds the CPU has spent in irq mode

Transition

Type:
  • object
Properties:
Name Type Description
opacity Opacity

The Opacity transition

position Position

The Position transition

size Size

The Size transition

TransitionOptions

Type:
  • object
Properties:
Name Type Description
interrupt boolean

This option interrupts the current animation. When false it pushes this animation onto the end of the animation queue.

relative boolean

Treat 'opacity' as absolute or as a delta. Defaults to false.

TrayInfo

TrayInfo interface

Type:
  • object
Properties:
Name Type Description
bounds Bounds

The bound of tray icon in virtual screen pixels

monitorInfo MonitorInfo

Please see fin.System.getMonitorInfo for more information

x number

copy of bounds.x

y number

copy of bounds.y

ViewsPreventingUnloadPayload

ViewsPreventingUnloadPayload interface

Type:
  • object
Properties:
Name Type Description
windowClose boolean

Specifies if the Window should close

windowId Identity

Identity of the Window

viewsPreventingUnload Array.<Identity>

Array of identities for the Views that are preventing an unload

viewsNotPreventingUnload Array.<Identity>

Array of identities for the Views that are not preventing an unload

closeType 'view' | 'window'

If the close action came from the Window or a single View

ViewStatuses

Type:
  • object
Properties:
Name Type Description
viewsPreventingUnload Array.<Identity>

Array of identities for the Views that are preventing an unload

viewsNotPreventingUnload Array.<Identity>

Array of identities for the Views that are not preventing an unload

ViewVisibility

Platform Windows Only. Controls behavior for showing views when they are being resized by the user.

Type:
  • Object
Properties:
Name Type Attributes Description
showViewsOnWindowResize ShowViewsOnWindowResize <optional>

Enables views to be shown when a Platform Window is being resized by the user.

showViewsOnSplitterDrag ShowViewsOnSplitterDrag <optional>

Allows views to be shown when they are resized by the user dragging the splitter between layout stacks.

showViewsOnTabDrag ShowViewsOnTabDrag <optional>

Supported on Windows Operating Systems only. Allows views to be shown when the user is dragging a tab around a layout.

WindowDetail

WindowDetail interface

Type:
  • object
Properties:
Name Type Description
bottom number

The bottom-most coordinate of the window

height number

The height of the window

isShowing boolean

Value to check if the window is showing

left number

The left-most coordinate of the window

name string

The name of the window

right number

The right-most coordinate of the window

state string

The window state

top number

The top-most coordinate of the window

width number

The width of the window

WriteRequestType

WriteRequestType interface

Type:
  • object
Properties:
Name Type Attributes Description
data string

Data to be written

type string <optional>

Clipboard Type