Monkeybread Xojo plugin - JavaScriptEngineMBS class

Platforms to show: All Mac Windows Linux Cross-Platform

JavaScriptEngineMBS class

Type	Topic	Plugin	Version	macOS	Windows	Linux	iOS	Targets
class	JavaScript	MBS Tools Plugin	20.0	✅ Yes	✅ Yes	✅ Yes	✅ Yes	All

Function: The class for our embedded JavaScript engine.
Notes:
We use DukTape, an embeddable Javascript engine, with a focus on portability and compact footprint.
https://duktape.org

Your own JavaScript engine is useful for:

Running some snippet of JavaScript code without HTMLViewer.
Using various JavaScript libraries
Providing a scripting language to your own application.
An lightweight alternative to XojoScript.
Working with JSON data
Enjoy using regular expressions, unicode text functions, number parsing and formatting with no platform dependencies

MBS Plugin added Input(), Yield() and Print() functions for your convenience.
Yield will pass CPU control to other threads, so background tasks continue to run.

MBS Plugin can convert JavaScript values to variant.
Boolean -> Boolean
Number -> Double
String -> String
Buffer -> MemoryBlock
Pointer -> Ptr
Array -> Variant array
Object -> JSON string
null -> nil

We convert variant to JavaScript:
nil -> null
Int32, Int64, Single, Double, Currency -> Number
Boolean -> Boolean
String, Text, Date -> String
Ptr -> Pointer
all other -> undefined

This class is like XojoScript, but using JavaScript as language.

Warning: error handling is broken in version 21.1 of the MBS Plugin. Please update to 22.2 for a fix.

2 events
- event Input(values() as Variant) as Variant
- event Print(values() as Variant)
7 properties
- property Handle as Integer
- property MemoryBlocks as Dictionary
- property ObjectCount as Integer
- property StringCount as Integer
- property GlobalMemoryBlock(PropertyName as String) as MemoryBlock
- property GlobalProperty(PropertyName as String) as Variant
- property GlobalPropertyJSON(PropertyName as String) as String
16 methods
- method AddFunction(Name as String, JavaScript as String, FileName as String = "")
- method CallFunction(Name as String, ParamArray Params as Variant) as Variant
- method CallFunction(Name as String, Params() as Variant) as Variant
- method CallFunctionMT(Name as String, ParamArray Params as Variant) as Variant
- method CallFunctionMT(Name as String, Params() as Variant) as Variant
- method DateComponentsToTime(date as JavaScriptDateComponentsMBS) as Double
- method Destructor
- method Evaluate(JavaScript as String) as Variant
- method EvaluateMT(JavaScript as String) as Variant
- method EvaluateToString(JavaScript as String) as String
- method InitModules
- method LoadFunction(Name as String, Data as Memoryblock) as Boolean
- method Now as Double
- method RegisterFunction(Name as String, theDelegate as JavaScriptEngineDelegateMBS, ArgCount as Integer = -1, tag as Variant = nil)
- method SaveFunction(Name as String) as MemoryBlock
- method TimeToDateComponents(time as Double) as JavaScriptDateComponentsMBS
delegate JavaScriptEngineDelegateMBS(Name as String, Params() as Variant, tag as Variant) as Variant

This class has no sub classes.

Some examples using this class:

Blog Entries

Xojo Developer Magazine

Videos

The items on this page are in the following plugins: MBS Tools Plugin.

JavaScriptEngineExceptionMBS - JavaShortArrayMBS

💬 Ask a question or report a problem