Topics   All   MacOS (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Deprecated   Guides   Examples   Videos
New in version: 10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2   11.3   11.4    Statistic    FMM    Blog  

JS.New

Creates a new JavaScript engine instance.

Component Version macOS Windows Linux Server iOS SDK
JavaScript 10.0 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "JS.New" { ; JSRef } )   More

Parameters

Parameter Description Example Flags
JSRef The desired js reference.
Usually each one gets a number assigned, but you can create a JavaScript environment with a fixed name, so you can anywhere reference it by name.
"JS" Optional

Result

Returns JS reference number or error.

Description

Creates a new JavaScript engine instance.
This object contains all the functions and properties you defined.
Please release the object later with the JS.Release function.

Your own JavaScript engine is useful for:

If JSRef is "js", we use this one as the global JavaScript engine for custom functions and JS.CF function. See our example JavaScript Custom Functions.

When using a name for the reference number, you can use this reference anywhere you need to pass a JavaScript reference number.

Examples

Evaluate a bit of JavaScript:

Set Variable [ $js ; Value: MBS( "JS.New" ) ]
Set Variable [ $r ; Value: MBS( "JS.Evaluate"; $js; "4+5") ]
Show Custom Dialog [ "Result" ; $r ]
Set Variable [ $r ; Value: MBS( "JS.Release"; $JS ) ]

Create named JavaScript Environment:

Set Variable [$js; MBS( "JS.New"; "js" ) ]

See also

Release notes

Example Databases

Blog Entries

FileMaker Magazin

Created 7th December 2019, last changed 14th June 2021


JS.List - JS.Now

Feedback: Report problem or ask question.