| Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision |
| custom:javascript [2019/04/28 02:44] – [Output] Document which output functions perform char set translations (e.g. EX-ASCII to ASCII or PETSCII) digital man | custom:javascript [2019/05/27 21:35] – [Integration] renamed to Invocation and provided more details. digital man |
|---|
| Modified stock ''.js'' files should be placed in your Synchronet ''[[dir:mods]]'' directory to prevent over-writing by future upgrades. | Modified stock ''.js'' files should be placed in your Synchronet ''[[dir:mods]]'' directory to prevent over-writing by future upgrades. |
| |
| ===== Integration ===== | ===== Invocation ===== |
| |
| JavaScript files can be executed from: | JavaScript files can be executed / invoked from: |
| * [[:server:terminal|Terminal Server]] | * [[:server:terminal|Terminal Server]] |
| as a timed event, external program (door), login/logon/newuser module, | as a timed event, external program (door), login/logon/newuser module, via the ''EXEC'' sysop command |
| basically anywhere a Baja module or executable can be launched | ((basically anywhere a Baja module or native or MS-DOS executable can be launched)) |
| * [[:server:web|Web Server]] | * [[:server:web|Web Server]] |
| dynamically generates HTML files, | dynamically generates HTTP responses (e.g. HTML/CSS content), |
| see ''[[dir:web]]/root/*.ssjs'' | see ''[[dir:web]]/root/*.ssjs'' |
| * [[:server:ftp|FTP Server]] | * [[:server:ftp|FTP Server]] |
| inbound mail processors may be written in JavaScript, | inbound mail processors may be written in JavaScript, |
| see ''[[dir:exec]]/[[module:mailproc_example]].js'' and ''[[dir:ctrl]]/[[config:mailproc.ini]]'' | see ''[[dir:exec]]/[[module:mailproc_example]].js'' and ''[[dir:ctrl]]/[[config:mailproc.ini]]'' |
| * [[:util:jsexec|JSexec]] | * [[:util:JSexec]] |
| some script files may be executed outside of Synchronet (e.g. as a CGI script or daemon) using jsexec, | some script files may be executed outside of Synchronet (e.g. as a CGI script or daemon) using [[util:JSexec]], |
| examples: ''ircd.js'', ''newslink.js'' | examples: ''ircd.js'', ''newslink.js'' |
| |
| From the Terminal Server, a JavaScript file is executed on a native command-line by placing a question mark (''?'') at the beginning of the command-line before the JavaScript file name (in [[util:scfg]]). It is not necessary to specify the ''.js'' portion of the file name on the command-line. For example, the command-line to execute the file ''[[dir:exec]]/newslink.js'' would be "''?newslink''" or "''?newslink.js''". | From the Terminal Server, a JavaScript file is executed on a native command-line by placing a question mark (''?'') or asterisk (''*'') at the beginning of the command-line before the JavaScript file name (in [[util:SCFG]]). It is not necessary to specify the ''.js'' portion of the file name on the command-line. For example, the command-line to execute the file ''[[dir:exec]]/newslink.js'' would be "''?newslink''" or "''*newslink''". |
| |
| From within a Baja module, a JavaScript file may be executed using the following Baja code: | From within a Baja module, a JavaScript file may be executed using the following Baja code: |
| exec "?modname" # where modname is the JavaScript file. | exec "?modname" # where modname is the JavaScript file. |
| </code> | </code> |
| | or: |
| | <code baja> |
| | exec "*modname" # where modname is the JavaScript file. |
| | </code> |
| ===== Object Model ===== | ===== Object Model ===== |
| |
| | ''log()'' | Yes | Yes | N/A | N/A | | Yes((following the log-level argument)) | Displayed/logged on the server only | | | ''log()'' | Yes | Yes | N/A | N/A | | Yes((following the log-level argument)) | Displayed/logged on the server only | |
| | ''console.print()'' | Yes | No | No | Yes | Telnet-IAC, Ctrl-A | Yes | | | | ''console.print()'' | Yes | No | No | Yes | Telnet-IAC, Ctrl-A | Yes | | |
| | ''console.write()'' | Yes | No | No | PETSCII only | Telnet-IAC | Yes | | | | ''console.write()'' | Yes | No | No | PETSCII only | Telnet-IAC | Yes | No line-counting/auto-pause | |
| | ''console.writeln()'' | Yes | No | Yes | PETSCII only | Telnet-IAC | Yes | | | | ''console.writeln()'' | Yes | No | Yes | PETSCII only | Telnet-IAC | Yes | No line-counting/auto-pause | |
| | ''console.putmsg()'' | Yes | No | No | Yes | Telnet-IAC, Ctrl-A, [[custom:atcodes|@-Codes]], [[custom:colors|Extra Attributes]] | No | Typically used for displaying text/menu files | | | ''console.putmsg()'' | Yes | No | No | Yes | Telnet-IAC, Ctrl-A, [[custom:atcodes|@-Codes]], [[custom:colors|Extra Attributes]] | No | Typically used for displaying text/menu files | |
| | ''console.center()'' | Yes | No | Yes | Yes | Telnet-IAC, Ctrl-A | No | Text centered on screen | | | ''console.center()'' | Yes | No | Yes | Yes | Telnet-IAC, Ctrl-A | No | Text centered on screen | |
| | ''client.socket.send()'' | Yes | No | No | No | | No | Avoid using | | | ''client.socket.send()'' | Yes | No | No | No | | No | Avoid using | |
| |
| | |
| | === Carriage Returns === |
| | If you wish to send a traditional "carriage return" character to the client terminal (i.e. move the cursor to the far left column without advancing to the next line) it is recommended that you use an output method/function that supports [[custom:Ctrl-A codes]] and you send the Ctrl-A ''['' sequences //instead of// an ASCII 13 (''\r'') character. This is required for PETSCII terminal compatibility, where an ASCII 13 character performs a complete "newline" sequence (the equivalent of ''\r\n'') on the client terminal. |
| ===== See Also ===== | ===== See Also ===== |
| * [[http://synchro.net/docs/jsobjs.html|Synchronet JavaScript Object Model]] | * [[http://synchro.net/docs/jsobjs.html|Synchronet JavaScript Object Model]] |
| * [[:custom:index|Customization]] | * [[:custom:index|Customization]] |
| |
| {{tag>javascript}} | {{tag>javascript petscii}} |
| |
