FarNet.JavaScriptFar 1.0.2

Prefix Reserved
There is a newer version of this package available.
See the version list below for details.
dotnet add package FarNet.JavaScriptFar --version 1.0.2                
NuGet\Install-Package FarNet.JavaScriptFar -Version 1.0.2                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="FarNet.JavaScriptFar" Version="1.0.2" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add FarNet.JavaScriptFar --version 1.0.2                
#r "nuget: FarNet.JavaScriptFar, 1.0.2"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install FarNet.JavaScriptFar as a Cake Addin
#addin nuget:?package=FarNet.JavaScriptFar&version=1.0.2

// Install FarNet.JavaScriptFar as a Cake Tool
#tool nuget:?package=FarNet.JavaScriptFar&version=1.0.2                

FarNet.JavaScriptFar

JavaScriptFar runs JavaScript scripts in .NET with FarNet API for Far Manager scripting.

The module is built with Microsoft ClearScript and Google V8 JavaScript engine.

Installation

How to install and update FarNet and modules
https://github.com/nightroman/FarNet#readme

Run commands

JavaScript statements and expressions are run from the command line with the prefix js:

js: pi = Math.PI
js: Math.sqrt(pi)

Run scripts

You can open scripts in the editor and run by pressing [F5]. The result value, if any, is shown in the title or a new editor.

Or you can run scripts from the command line using js:@ and a script path. Paths may be absolute or relative to the current panel folder. Environment variables are expanded.

js: @ hello-world.js
js: @ %scripts%\hello-world.js

Create the file association for *.js scripts and run current scripts from panels by [Enter]:

*.js;*.cjs;*.mjs
js:@!\!.!

The following extra prefixes may be specified before @:

  • task: tells to start the script or command as a task

Example:

js: task: @ too-slow.js

Scripts running as tasks should not call Far API unless it is designed for multi-threaded scenarios and documented accordingly.

Parameters

In order to pass parameters to scripts, use :: after the file name followed by semicolon separated key=value pairs (connection string format):

js: @ user.js :: name = John Doe; age = 42

These parameters are available in JavaScript as the property bag variable args.

The special parameter _session may define the target folder session path.

Parameters apply to commands as well. This example calls test defined in a particular session (e.g. auto loaded by session scripts) and sends the file parameter:

js: test(args.file) :: _session=C:\Test; file=C:\Test\test1.json

Global variables

  • args - property bag of named parameters from command line or interop
  • host - extended JavaScript functions provided by ClearScript, see here
  • far - FarNet main methods, shortcut to clr.FarNet.Far.Api see here
  • clr - .NET types of the following assemblies:
    • mscorlib
    • System
    • System.Core
    • System.Diagnostics.Process
    • System.Numerics
    • System.Runtime
    • ClearScript.Core
    • FarNet

Folder sessions

JavaScript files and commands are run in "folder sessions". The script folder or the current panel folder is used if it contains a file like _session.*. Otherwise the main folder %FARPROFILE%\FarNet\JavaScriptFar is used. Its session files, if any, work for all scripts and commands with no own session.

Any file _session.* engages its folder session on running scripts and commands, even if the file is not used by the module, e.g. _session.txt.

Used session files:

  • Configuration file _session.xml

    This file configures the session JavaScript engine. The existing file is edited or a new is created by F11 / JavaScriptFar / Configuration. This is the recommended way of editing configurations, it validates the schema and some data.

    For configuration values and doc comments, see SessionConfiguration.cs.

  • Session scripts, *.js, *.cjs, *.mjs in _session.*

    All session scripts are loaded once, in alphabetical order, case ignored. Other scripts in this folder or others for the main session may use the assets defined by session scripts.

You may view created sessions by F11 / JavaScriptFar / Sessions. Keys and actions:

  • [Enter] - go to the session folder.
  • [Del] - close the session.

Normally you do not have to close sessions, they do not consume much resources unless you store a lot of data in session variables. But closing may be useful on development, on changes in sessions files, for terminating debugged session (marked with a tick), and etc.

Debugging

Prerequisites:

To start debugging of the current folder session, use F11 / JavaScriptFar / Start debugging. This terminates other debugged sessions, if any. Just one session may be debugged at a time.

VSCode is opened. Prepare the session for debugging in VSCode. Open scripts and set breakpoints. Optionally enable breaks on caught / uncaught exceptions.

Then start the ClearScript V8 debugger in VSCode, ensure it is selected as the current and press [F5].

Switch to Far Manager and run a script or command. The debugger breaks on hit breakpoints, some exceptions, and debugger statements in the JavaScript code.

VSCode debugger is useful for examining variable values, object properties and methods, typing commands in the debug console, watching the output of console functions.

See also

There are no supported framework assets in this package.

Learn more about Target Frameworks and .NET Standard.

This package has no dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.0.2 409 3/25/2024
2.0.1 283 1/30/2024
2.0.0 402 11/19/2023
1.0.4 485 10/18/2023
1.0.3 429 4/9/2023
1.0.2 483 1/23/2023
1.0.1 419 1/1/2023
1.0.0 385 11/18/2022
0.4.4 470 10/1/2022
0.4.3 499 9/16/2022
0.4.2 517 8/25/2022
0.4.1 519 8/9/2022
0.4.0 493 8/8/2022
0.3.0 529 8/5/2022
0.2.1 481 8/4/2022
0.2.0 475 8/3/2022
0.1.0 527 7/25/2022
0.0.2 508 7/23/2022
0.0.1 498 7/22/2022