Class OperatorTerm

A type of RollTerm used to denote and perform an arithmetic operation.

Hierarchy (View Summary)

Properties

_root isIntermediate operator options FLAVOR_REGEXP FLAVOR_REGEXP_STRING OPERATORS PRECEDENCE REGEXP SERIALIZE_ATTRIBUTES

Accessors

expression flavor formula isDeterministic resolver total

Methods

evaluate toJSON _evaluate _fromData fromData fromJSON fromParseNode isDeterministic

Properties

Internal_root

_root: Roll

A reference to the Roll at the root of the evaluation tree.

isIntermediate

isIntermediate: boolean = false

Is this term intermediate, and should be evaluated first as part of the simplification process?

operator

operator: string

The term's operator value.

options

options: object

An object of additional options which describes and modifies the term.

StaticFLAVOR_REGEXP

FLAVOR_REGEXP: RegExp = ...

A regular expression which identifies term-level flavor text

StaticFLAVOR_REGEXP_STRING

FLAVOR_REGEXP_STRING: string = "(?:\\[([^\\]]+)\\])"

A regular expression pattern which identifies optional term-level flavor text

StaticOPERATORS

OPERATORS: string[] = ...

An array of operators which represent arithmetic operations

StaticPRECEDENCE

PRECEDENCE: Readonly<Record<string, number>> = ...

An object of operators with their precedence values.

StaticREGEXP

REGEXP: RegExp = ...

StaticSERIALIZE_ATTRIBUTES

SERIALIZE_ATTRIBUTES: string[] = ...

Accessors

expression

  • get expression(): string

    Returns string

flavor

  • get flavor(): string

    Returns string

formula

  • get formula(): string

    A string representation of the formula, including optional flavor text.

    Returns string

isDeterministic

  • get isDeterministic(): boolean

    Whether this term is entirely deterministic or contains some randomness.

    Returns boolean

resolver

  • get resolver(): RollResolver

    A reference to the RollResolver app being used to externally resolve this term.

    Returns RollResolver

total

  • get total(): string

    Returns string

Methods

evaluate

  • evaluate(
        options?: {
            allowStrings?: boolean;
            maximize?: boolean;
            minimize?: boolean;
        },
    ): RollTerm
    | Promise<RollTerm>

    Evaluate the term, processing its inputs and finalizing its total.

    Parameters

    • Optionaloptions: { allowStrings?: boolean; maximize?: boolean; minimize?: boolean } = {}

      Options which modify how the RollTerm is evaluated

      • OptionalallowStrings?: boolean

        If true, string terms will not throw an error when evaluated.

      • Optionalmaximize?: boolean

        Maximize the result, obtaining the largest possible value.

      • Optionalminimize?: boolean

        Minimize the result, obtaining the smallest possible value.

    Returns RollTerm | Promise<RollTerm>

    Returns a Promise if the term is non-deterministic.

toJSON

  • toJSON(): RollTermData

    Serialize the RollTerm to a JSON string which allows it to be saved in the database or embedded in text. This method should return an object suitable for passing to the JSON.stringify function.

    Returns RollTermData

Protected_evaluate

  • _evaluate(options?: object): RollTerm | Promise<RollTerm>
    Protected

    Evaluate the term.

    Parameters

    • Optionaloptions: object = {}

      Options which modify how the RollTerm is evaluated, see RollTerm#evaluate

    Returns RollTerm | Promise<RollTerm>

    Returns a Promise if the term is non-deterministic.

Static_fromData

StaticfromData

StaticfromJSON

  • fromJSON(json: string): RollTerm

    Reconstruct a RollTerm instance from a provided JSON string

    Parameters

    • json: string

      A serialized JSON representation of a DiceTerm

    Returns RollTerm

    A reconstructed RollTerm from the provided JSON

StaticfromParseNode

StaticisDeterministic

  • isDeterministic(
        term: RollTerm,
        options?: { maximize?: boolean; minimize?: boolean },
    ): boolean

    Determine if evaluating a given RollTerm with certain evaluation options can be done so deterministically.

    Parameters

    • term: RollTerm

      The term.

    • Optionaloptions: { maximize?: boolean; minimize?: boolean } = {}

      Options for evaluating the term.

      • Optionalmaximize?: boolean

        Force the result to be maximized.

      • Optionalminimize?: boolean

        Force the result to be minimized.

    Returns boolean

Settings

Member Visibility

On This Page

Properties
Accessors
Methods