Global

Type Definitions

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.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).
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).
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.

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

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.

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.

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.

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.

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 Description
name string

The name of the running application
uuid string

The uuid of the running application