OpenFin Node.js adapter
Allows the use of the OpenFin API from node.js. Please note the launch and connect methods are specific to a node environment.
Requirements
- Node.js LTS ^6.9
Install as dependency
$ npm install -S openfin-adapter
Usage
Using the fin api from an Applications context
init.js
import { fin } from 'openfin-adapter/src/mock';
(() => {
if (fin.me.isView) {
fin.me.getCurrentWindow();
// returns => Promise<OpenFin.Window> only when in a View's context.
}
if(fin.me.isFrame) {
fin.me.getInfo();
// returns => Promise<OpenFin.FrameInfo> only when in a Frame's context.
}
if (fin.me.isWindow) {
fin.me.getCurrentViews();
// returns => Promise<OpenFin.View[]> only when in a Window's context.
}
})();Using the fin api in node
Connecting to an already running runtime
connect.js
import { connect } from 'openfin-adapter';
export async function connectFromNode() {
try {
const { fin } = await connect({
address: "ws://localhost:9696",
uuid: "my-uuid-123"
});
const version = await fin.System.getVersion();
console.log("Connected to OpenFin runtime version:", version);
const platform = await fin.Platform.startFromManifest('https://openfin.github.io/golden-prototype/public.json');
console.log('Platform is running, wrapped platform: ', platform);
return fin;
} catch(e) {
throw new Error(`Error: \n${e}`);
}
}init.js
import { connectFromNode } from './connect.js'
(async () => {
try {
const fin = await connectFromNode();
console.log(`You are connected to node with this fin instance: \n${fin}`);
} catch(e) {
throw new Error(`Error connecting to from node: \n${e}`);
}
})();Launching a runtime from node
launchFromNode.js
import { launch } from 'openfin-adapter';
export async function launchFromNode() {
try {
const { fin } = await launch({
uuid: "my-uuid-123",
runtime: {
version: 'stable'
}
});
const version = await fin.System.getVersion();
console.log("Connected to OpenFin runtime version:", version);
const platform = await fin.Platform.startFromManifest('https://openfin.github.io/golden-prototype/public.json');
console.log('Platform is running, wrapped platform: ', platform);
return fin;
} catch(e) {
throw new Error(`Error: \n${e}`);
}
}init.js
import { launchFromNode } from './launchFromNode.js'
(async () => {
try {
const fin = await launchFromNode();
console.log(`You successfully connected from node with to a runtime with this fin instance: \n${fin}`);
} catch(e) {
throw new Error(`Error connecting to from node: \n${e}`);
}
})();License
The code in this repository is distributed under the Apache License, Version 2.0
However, if you run this code, it may call on the OpenFin RVM or OpenFin Runtime, which are covered by OpenFin's Developer, Community, and Enterprise licenses. You can learn more about OpenFin licensing at the links listed below or just email us at support@openfin.co with questions.
Copyright 2020-2021 OpenFin