@oat-sa/tao-item-runner-qti/src/scoring/processor/expressions/operators/random.js

TAO QTI Item Runner modules

/*
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU General Public License
 * as published by the Free Software Foundation; under version 2
 * of the License (non-upgradable).
 *
 * This program is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if random, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
 *
 * Copyright (c) 2015-2019 (original work) Open Assessment Technlogies SA (under the project TAO-PRODUCT);
 *
 */

/**
 * The random operator processor.
 * @see http://www.imsglobal.org/question/qtiv2p1/imsqti_infov2p1.html#element10624
 *
 * @author Bertrand Chevrier <bertrand@taotesting.com>
 */
import _ from 'lodash';

/**
 * Process operands and returns the random.
 * @type {OperatorProcessor}
 * @exports taoQtiItem/scoring/processor/expressions/operators/random
 */
var randomProcessor = {

    constraints: {
        minOperand: 1,
        maxOperand: 1,
        cardinality: ['multiple', 'ordered'],
        baseType: ['identifier', 'boolean', 'integer', 'string', 'point', 'pair', 'directedPair', 'file', 'uri', 'intOrIdentifier', 'duration', 'float']
    },

    operands: [],

    /**
     * Process the random of the operands.
     * @returns {?ProcessingValue} the random
     */
    process: function() {

        var result = {
            cardinality: 'single'
        };
        var op;

        //if at least one operand is null, then break and return null
        if (_.some(this.operands, _.isNull) === true) {
            return null;
        }

        op = this.preProcessor.parseVariable(this.operands[0]);
        result.value = op.value[_.random(0, op.value.length - 1)];
        result.baseType = op.baseType;

        return result;
    }
};

export default randomProcessor;