acts-package-javascript 0.26.0

acts package that runs JavaScript code with an embedded QuickJS runtime
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51

# acts-package-javascript

The acts package plugin that runs JavaScript code with an embedded
[QuickJS](https://bellard.org/quickjs/) runtime, registered as the
`acts.app.javascript` workflow act.

The engine's own `${{ }}` expression evaluator is `acts-expr` (in the `acts`
crate); QuickJS lives here, behind the `acts.app.javascript` package
that executes arbitrary JavaScript for variable computation and transformation.
Task data reaches the script through `${{ }}` placeholders (evaluated by the
engine), and the script hands data back by returning a JSON object.

## Installation

```bash
cargo add acts-package-javascript
```

## Start

```rust,no_run
use acts::Engine;
use acts_package_javascript::CodePackage;

#[tokio::main]
async fn main() {
    let engine = Engine::builder()
        .add_package::<CodePackage>()
        .start()
        .await
        .unwrap();
}
```

## Example

```yaml
id: code_demo
ver: 0.1.0
vars:
  - name: value
    value: 21
steps:
  - uses: acts.app.javascript
    params: |
      return { doubled: ${{ value }} * 2, upper: "hello".toUpperCase() };
```

The JavaScript runs in its own QuickJS realm per evaluation, with the
`console` logging methods and `Array.prototype.union`/`intersection`/
`difference` extensions available.