Monkeybread Software - MBS FileMaker Plugin: JS.New

Components	All	New	MacOS		Windows		Linux		iOS
Examples	Mac & Win		Server	Client	Guides	Statistic	FMM	Blog	Deprecated	Old

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

Added in version 11.3.

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 Added in version 11.3.

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:

Running some snippet of JavaScript code without web viewer.
Using various JavaScript libraries
Providing a scripting language to your own solution.
Doing JavaScript on server side.
Working with JSON data
Enjoy using regular expressions, unicode text functions, number parsing and formatting with no platform dependencies

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.

Check also our JavaScriptWebKit functions for using WebKit’s JavaScript engine on macOS and iOS.

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 ) ]
Evaluate a bit of JavaScript:

<?xml version="1.0" encoding="UTF-8"?>
<fmxmlsnippet type="FMObjectList">
  <Step enable="True" id="141" name="Set Variable">
    <Value>
      <Calculation>MBS( "JS.New" ) </Calculation>
    </Value>
    <Repetition>
      <Calculation>1</Calculation>
    </Repetition>
    <Name>$js</Name>
  </Step>
  <Step enable="True" id="141" name="Set Variable">
    <Value>
      <Calculation>MBS( "JS.Evaluate"; $js; "4+5") </Calculation>
    </Value>
    <Repetition>
      <Calculation>1</Calculation>
    </Repetition>
    <Name>$r</Name>
  </Step>
  <Step enable="True" id="87" name="Show Custom Dialog">
    <Title>
      <Calculation> "Result" </Calculation>
    </Title>
    <Message>
      <Calculation>$r </Calculation>
    </Message>
    <Buttons>
      <Button CommitState="True">
        <Calculation>"OK"</Calculation>
      </Button>
      <Button CommitState="False">
        <Calculation>"Cancel"</Calculation>
      </Button>
      <Button CommitState="False"/>
    </Buttons>
  </Step>
  <Step enable="True" id="141" name="Set Variable">
    <Value>
      <Calculation>MBS( "JS.Release"; $JS ) </Calculation>
    </Value>
    <Repetition>
      <Calculation>1</Calculation>
    </Repetition>
    <Name>$r</Name>
  </Step>
</fmxmlsnippet>

Create named JavaScript Environment:

Set Variable [$js; MBS( "JS.New"; "js" ) ]
Create named JavaScript Environment:

Release notes

Version 11.3
- Added parameter for JS.New function to define the identifier used for the new instance.

Example Databases

Blog Entries

FileMaker Magazin

This function checks for a license.

Created 7th December 2019, last changed 4th July 2024

JS.List - JS.Now

💬 Ask a question or report a problem