Add Jump

src/core/operations/Jump.mjs

@@ -0,0 +1,66 @@
+/**
+ * @author n1474335 [n1474335@gmail.com]
+ * @copyright Crown Copyright 2018
+ * @license Apache-2.0
+ */
+
+import Operation from "../Operation";
+import { getLabelIndex } from "../lib/FlowControl";
+
+/**
+ * Jump operation
+ */
+class Jump extends Operation {
+
+    /**
+     * Jump constructor
+     */
+    constructor() {
+        super();
+
+        this.name = "Jump";
+        this.flowControl = true;
+        this.module = "Default";
+        this.description = "Jump forwards or backwards to the specified Label";
+        this.inputType = "string";
+        this.outputType = "string";
+        this.args = [
+            {
+                "name": "Label name",
+                "type": "string",
+                "value": ""
+            },
+            {
+                "name": "Maximum jumps (if jumping backwards)",
+                "type": "number",
+                "value": 10
+            }
+        ];
+    }
+
+    /**
+     * @param {string} input
+     * @param {Object[]} args
+     * @returns {string}
+     */
+    run(state) {
+        const ings     = state.opList[state.progress].ingValues;
+        const label = ings[0];
+        const maxJumps = ings[1];
+        const jmpIndex = getLabelIndex(label, state);
+
+        if (state.numJumps >= maxJumps || jmpIndex === -1) {
+            log.debug("Maximum jumps reached or label cannot be found");
+            return state;
+        }
+
+        state.progress = jmpIndex;
+        state.numJumps++;
+        log.debug(`Jumping to label '${label}' at position ${jmpIndex} (jumps = ${state.numJumps})`);
+        return state;
+
+    }
+
+}
+
+export default Jump;