Bind getBar, setBar isBarVisible and setBarVisible to javascript

[fishface60]

Identify the Bug or Feature request

resolves #4898

Description of the Change

Add token.getBar, token.setBar, token.isBarVisible and token.setBarVisible functions to the JavaScript macro context.

See https://richardmaw.gitlab.io/maptool-bar-test/ for example campaign properties and add-on demonstrating the change.

Possible Drawbacks

This may stabilise an API with problems.

Documentation Notes

token.isBarVisible() Function

• Introduced in version 1.15.1

Returns true if the named bar is visible, false if it is not.

Usage

let visibility = token.isBarVisible(barName);

• barName - The name of the state to check for.

See isBarVisible() for MTScript equivalent.

token.setBarVisible() Function

Note: Using this function on tokens you do not own is only possible in a Trusted Macro

• Introduced in version 1.15.1

Changes bar visibility.

Usage

token.setBarVisible(barName, state);

• barName - The name of the state to check for.
• state - Hides the bar if false or enables it if true.

See setBarVisible() for MTScript equivalent.

token.getBar() Function

• Introduced in version 1.15.1

Returns the current value of the named bar, or 0 if it is not visible.

Usage

let value = token.getBar(barName);

• barName - The name of the state to check for.

See getBar() for MTScript equivalent.

token.setBar() Function

Note: Using this function on tokens you do not own is only possible in a Trusted Macro

• Introduced in version 1.15.1

Set the value of the named bar, enabling it if it was hidden.

Usage

token.setBar(barName, value);

• barName - The name of the state to check for.
• value - A number between 0 and 1 representing the bar's progress.

See setBar() for MTScript equivalent.

Release Notes

• Added token.getBar, token.setBar, token.isBarVisible and token.setBarVisible functions to the JavaScript macro context.

---

This change is