Skip to main content


Laurence MorganLess than 1 minute


Return values for events


Some events support return parameters outside of your typical STDOUT and STDERR streams. $EVENT_RETURN allows you to modify those parameters.


event onPreview example=exec {
    -> set event
    out "Preview event for $(event.Interrupt.PreviewItem)"
    $EVENT_RETURN.CacheTTL = 0 # don't cache this response.


$EVENT_RETURN will support different values for different events. Please read the respective event document for details on using this variable.

Other Reserved Variables

See Also

  • event: Event driven programming for shell scripts
  • json: JavaScript Object Notation (JSON)
  • onKeyPress: Custom definable key bindings and macros
  • onPreview: Full screen previews for files and command documentation

This document was generated from gen/variables/EVENT_RETURN_doc.yamlopen in new window.

Last update:
Contributors: Laurence Morgan