Both sides previous revisionPrevious revision | Next revisionBoth sides next revision |
dev:client_coding:javascript_api [2019/06/11 03:44] – [Running Ad Hoc JavaScript in Zotero] dstillman | dev:client_coding:javascript_api [2019/08/05 05:54] – [Running Ad Hoc JavaScript in Zotero] dstillman |
---|
Zotero includes an option to run arbitrary privileged JavaScript: | Zotero includes an option to run arbitrary privileged JavaScript: |
| |
- In the Advanced pane of the Zotero preferences, select Config Editor, and then set ''devtools.chrome.enabled'' to ''true'' and restart Zotero. | - In the Tools → Developer menu, select Run JavaScript. Opening the Error Console, which appears in the same menu, will also be helpful. |
- In the Tools menu, select Run JavaScript. Open the Error Console, which also appears in Tools, will also be helpful. | |
- In the window that opens, enter JavaScript in the Code textbox and click Run or press Cmd-R/Ctrl-R. | - In the window that opens, enter JavaScript in the Code textbox and click Run or press Cmd-R/Ctrl-R. |
| |
To run asynchronous code, check the "Run as async function" checkbox. This runs the entered code wrapped in an [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function|async function]], allowing you to use ''await'' to wait for the resolution of promises returned by functions. Most Zotero functions that access the database, disk, or network are asynchronous. In this mode, the value of a ''return'' statement will be displayed in the right-hand pane upon successful completion. | When running asynchronous code containing ''await'', the entered code is wrapped in an [[https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Statements/async_function|async function]], allowing you to wait for the resolution of promises returned by functions. Most Zotero functions that access the database, disk, or network are asynchronous. In this mode, the value of a ''return'' statement will be displayed in the right-hand pane upon successful completion. |
| |
In synchronous mode, the value of the final line will appear in the right-hand pane. | In synchronous mode, the value of the final line will appear in the right-hand pane. |