Name: insert script

Type: command

Syntax: insert [the] script of <object> into {front | back}

Summary: Places an <object|object's> <script> into the <message path>.

Introduced: 1.0

OS: mac,windows,linux,ios,android

Platforms: desktop,server,web,mobile

Example:
insert the script of button "Message Library" into back

Example:
insert the script of this card into front

Parameters:
object: The object is any object in an open stack.

Description:
Use the insert script command to use an object's script as a library for frequently-used handlers.

A script inserted into the front receives messages first, before the target object receives them. A script inserted into the back receives messages after all objects in the message path, just before the engine itself receives the message.

Objects added to the front or back are placed at the start of the <frontScripts> or <backScripts> list:  the last-inserted object gets messages first.

Be aware that inserting scripts may make it difficult to understand how a stack behaves. If you use this command for development, be sure to carefully document which scripts are inserted, where, and when.

References: script (property), remove script (command), place (command), call (command), start using (command), object (object), message path (glossary), backScripts (function), frontScripts (function)

Tags: objects
