js:MTScript: Difference between revisions

From RPTools Wiki
Jump to navigation Jump to search
(Created page with "Within the javascript environment used by {{code|js.eval}}, {{code|MTScript}} is the entry point for interacting with mtscript variables and macros. {{MacroFunction |name=MTS...")
 
No edit summary
Line 76: Line 76:


}}
}}
{{MacroFunction
|name=MTScript.getMTScriptCallingArgs;
|trusted=true
|version=1.9.4
|description=
Returns the arguments passed to `js.eval` as a list.
|usage=
<source lang="javascript" line>
MTScript.getMTScriptCallingArgs()
</source>


'''Parameters'''
* {{code|return}} list of arguments passed to the current `js.eval` call.
}}





Revision as of 06:15, 4 August 2021

Within the javascript environment used by js.eval, MTScript is the entry point for interacting with mtscript variables and macros.


MTScript.abort() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.9.4
Similar to the abort() macro, but accepts no arguments. Immediately halts macro execution with no message.

Usage

MTScript.abort()

Parameters

  • throws - AbortFunctionException


MTScript.mtsAssert;() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.9.4
Like the assert() macro.

Usage

MTScript.mtsAssert(check, message, pad=true)

Parameters

  • check Value to check: if true, do nothing.
  • message Message to include in the error if check is false.
  • pad If true, wrap the error in a localized error string.
  • throws AssertFunctionException if check is false.


MTScript.evalMacro;() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.9.4
Run a mtscript macro in the current macro context.

Usage

MTScript.evalMacro(macro)

Parameters

  • macro String to run as a macro.
  • return Any mtscript type.


MTScript.execMacro;() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.9.4
Run a mtscript macro in a new macro context. This is similar to evalMacro, except variables from the previous macro context are unavailable, and changes to mtscript variables from within this macro are discarded when the macro exits.

Usage

MTScript.execMacro(macro)

Parameters

  • macro String to run as a macro.
  • return Any mtscript type.


MTScript.getMTScriptCallingArgs;() Function

 Note: This function can only be used in a Trusted Macro

Introduced in version 1.9.4
Returns the arguments passed to `js.eval` as a list.

Usage

MTScript.getMTScriptCallingArgs()

Parameters

  • return list of arguments passed to the current `js.eval` call.


See Also

JS: MapTool