Promises in FM Web Viewers!
It's like fetch() for FileMaker! Go'fer some data. Call FileMaker scripts from JavaScript in a web viewer and get the response back using async/await.
Check out ./example/FMGofer.fmp12
. This example demostrates the callback, resolve, reject, and timeout capabilities of the library. You can rebuild the example code used in the fm file by running npm run build && npm run build:example
. This will output an html file in example/dist/index.html, which can be used in a FM webviewer.
npm install --save fm-gofer
import FMGofer, { Option } from 'fm-gofer';
const FMGofer = require('fm-gofer');
const { Option } = FMGofer;
<!-- This will set a global window property FMGofer -->
<script src="https://unpkg.com/fm-gofer/dist/fm-gofer.umd.cjs"></script>
<script>
// This will set a global window property FMGofer
(copy of ./dist/fm-gofer.umd.cjs)
</script>
import FMGofer, { Option } from 'fm-gofer';
const a = await FMGofer.PerformScript('FM Script', param);
// use the Option enum to specify the script option in human-readable form:
const b = await FMGofer.PerformScriptWithOption(
'FM Script',
param,
Option.SuspendAndResume
);
// Set a custom timeout/timeout message if the default to wait indefinitely is too long
import FMGofer, { Option } from 'fm-gofer';
const c = await FMGofer.PerformScript('FM Script', param, 5000, 'timed out!');
const d = await FMGofer.PerformScriptWithOption(
'FM Script',
param,
Option.SuspendAndResume,
5000,
'timed out!'
);
// Or if you file returns JSON, you can use the json() method to parse the result
const parsedData = await FMGofer.PerformScript('FM Script').json();
To return data to JS, extract callbackName
and promiseID
from Get ( ScriptParameter )
, and use it to call back to JS and resolve/reject the promise. Pass True
as the last param ("failed") to reject the promise.
Set Variable [ $callbackName ; JSONGetElement ( Get(ScriptParameter) ; "callbackName" ) ]
Set Variable [ $promiseID ; JSONGetElement ( Get(ScriptParameter) ; "promiseID" ) ]
# this contains param data sent from JS
Set Variable [ $parameter ; JSONGetElement ( Get(ScriptParameter) ; "parameter" ) ]
# callback to JS like: $callbackName($promiseID, <dataToReturn>, <trueToReject>)
# (leave the third argument empty or False to indicate a success. Or set to True to indicate an error)
Perform JavaScript in Web Viewer [ Object Name: "myWebview" ; Function Name: $callbackName ; Parameters: $promiseID, 'Success! Hello from FM!' ]
// You can assert the shape of the result returned from FM using typescript!
interface MyResult {
name: string;
age: number;
}
const j = await FMGofer.PerformScript('FM Script', param).json<MyResult>();
// Nested properties auto-complete in VSCode now!
const name = j.name;
const age = j.age;
npm test
npm run build
If you see anything that should be improved please feel free to let me know or send pull requests.