Standard Library of Custom Actions

You can use the Cherri Standard Library of custom actions using the following syntax:

#include 'stdlib'

This will give you access to the following actions. Note that custom actions are only included with your Shortcut if you use them.

Scripting

Choose from vCard

Prompt the user to choose from an array of vCards with a prompt. Returns the chosen vCard item.

chooseFromVCard(array items, text prompt)

Example Usage

#include 'stdlib'

@items = []
repeat i for 3 {
  @items += makeVCard("Title", "Subtitle")
}

chooseFromVCard(items, "Choose From Items")

---

Run JavaScript

Runs the JavaScript code in script and returns the output.

runJS(text script)

Basic Usage

#include 'stdlib'

const jsonStr = '{\"name\": \"John\", \"age\": 30\}'

const code = "
    const json = JSON.parse('{jsonStr}')
    document.body.append(document.createTextNode(json.name));
"

const jsResult = runJS(code)

show(jsResult)

You can also use base64File() to encode a large JS file into your Shortcut without needing to paste it.

index.js

function output(output) {
    document.body.append(document.createTextNode(output));
}

output('Hello, World!');

js.cherri

#include 'stdlib'

const jsFile = base64File("path/to/index.js")
const jsCode = base64Decode(jsFile)

@result = runJS(jsCode)

show(result)