Differences

This shows you the differences between two versions of the page.

--- action:Execute_a_JavaScript_in_Custom_Prompt [2016/04/27 04:06]
peternlewis
+++ action:Execute_a_JavaScript_in_Custom_Prompt [2016/07/30 14:30]
JMichaelTX ADD Example with screenshot
@@ Line 1: / Line 1: @@
-The Execute JavaScript in Custom Prompt action(7.1+) allows you to execute a specified JavaScript, either from a file or text within a currently open Custom HTML Prompt. The JavaScript is executed in all [Custom HTML Prompt](https://wiki.keyboardmaestro.com/action/Custom_HTML_Prompt) action with a matching windowid, or all if no windowid is specified. The JavaScript can return results. Options for the results of a JavaScript results are:
+{{:action:javascript-icon.png?nolink|}}
+====== Execute JavaScript in Custom HTML Prompt Action ======
-  *ignore results.
-  *display results in a window.
+The Execute JavaScript in Custom Prompt action (version 7.1+) allows you to execute a specified JavaScript in any active Keyboard Maestro [[action:Custom_HTML_Prompt|Custom HTML Prompt]].
-  *display results briefly.
-  *display results large.
+The **Execute JavaScript in Custom Prompt** action is the functional equivalent for the Custom HTML Prompt to these actions:
-  *type results.
-  *paste results.
+* [Execute JavaScript in Safari](https://wiki.keyboardmaestro.com/action/Execute_a_JavaScript_in_Google_Chrome)
-  *save results to variable.
+* [Execute JavaScript in Chrome](https://wiki.keyboardmaestro.com/action/Execute_a_JavaScript_in_Google_Chrome)
-  *save results to the system clipboard or a named clipboard.
-  *save results asynchronously  — the action runs while the macro continues on.
+===== Example =====
+{{:action:km-7.2-execute-script-in-html-prompt-example.png?nolink|}}
+Note the purpose of this example is to close an existing HTML Prompt window, and it calls a custom JavaScript function already in the Custom HTML Prompt.  The Action option of "asynchronously" is chosen to avoid timeout of the Action.  Otherwise, the Action will wait for a response from the HTML Prompt, which will never come.
+===== Source of Script =====
+The JavaScript may be from any of the following:
+* From a JavaScript file
+* From the text script in the Action
+* Using any custom functions in the HTML Prompt.
+===== Target of Script =====
+The JavaScript is executed in a specific [[action:Custom_HTML_Prompt]] action with a matching [[action:Custom_HTML_Prompt#HTML_Window_Design|data-kmwindowid]], or all Custom HTML Prompts if no windowid is specified.
+===== Results of Action =====
+This Action can (optionally) return the results of the JavaScript:
+  * ignore results
+  * display results in a window
+  * display results briefly
+  * display results large
+  * type results
+  * paste results
+  * save results to variable
+  * save results to clipboard
+    * Either the system clipboard or a named clipboard
+  * asynchronously
+    * Results are **not** saved
+    * The macro immediately continues to the next action, which runs in parallel with the current action
 If the results are to be saved to a variable or a clipboard then further text areas appear in the action allowing you to specify the variable or specific clipboard.
+===== Access to Keyboard Maestro Variables =====
 The JavaScript can access variables by using the window.KeyboardMaestro functions described in the [Custom HTML Prompt](https://wiki.keyboardmaestro.com/action/Custom_HTML_Prompt) action.
+===== Related Forum Topics =====
+* [Execute JavaScript in Custom Prompt Question ](https://forum.keyboardmaestro.com/t/execute-javascript-in-custom-prompt-question/4491)

Keyboard Maestro Wiki

User Tools

Site Tools

Differences

Page Tools