Type Definitions
AddClientToContextGroupOptions
AddClientToContextGroupOptions interface
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
contextGroupId |
string | Name of the context group. |
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 |
ApplicationInfo
ApplicationInfo 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 |
ApplicationOption
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.startname
is optional in the app manifest but required by Application.starturl
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 |
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., |
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. |
name |
string |
<optional> |
The name of the application (and the application's main window). If provided, must match |
|
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). |
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 |
||
enableJumpList |
boolean |
<optional> |
false | Enables the use of the Jumplists API and the 'pin to taskbar' functionality. Only relevant in Windows. |
webSecurity |
boolean |
<optional> |
true | When set to |
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. |
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 |
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. |
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. |
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 in a context group.
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
id |
object |
<optional> |
An object containing 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. |
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. |
CrashReporterOption
CrashReporterOption interface
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
diagnosticMode |
boolean | In diagnostic 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: |
|
color |
string |
<optional> |
The color that should be associated within this context group when displaying this context group in a UI, e.g: |
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 |
Entity
Entity interface
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
type |
string | The type of the entity |
uuid |
string | The uuid of the entity |
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 |
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' |
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 the operation is first request or a follow up. |
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 |
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. |
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 |
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 |
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 |
componentState |
View~options |
<optional> |
Only a |
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
|
|||||||||
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. |
||||||||
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 |
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 |
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. |
MenuItemTemplate
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 |
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 |
submenu |
Array.<MenuItemTemplate> |
<optional> |
Should be specified for |
MenuResult
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 |
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 |
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 |
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 |
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 |
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 |
number |
<optional> |
The window y coordinate where to show the menu. Defaults to mouse position. If using must also use |
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:
- string | AppMetadata
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 |
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 |
WindowInfo
WindowInfo 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 |
WindowMovementOptions
Type:
- object
Properties:
Name | Type | Description |
---|---|---|
moveIndependently |
boolean | Move a window independently of its group or along with its group. Defaults to false. |
WriteRequestType
WriteRequestType interface
Type:
- object
Properties:
Name | Type | Attributes | Description |
---|---|---|---|
data |
string | Data to be written |
|
type |
string |
<optional> |
Clipboard Type |