pip-services3-commons-node/obj/src/random/RandomBoolean.js

Portable abstractions and patterns for Pip.Services in Node.js

"use strict";
/** @module random */
Object.defineProperty(exports, "__esModule", { value: true });
/**
 * Random generator for boolean values.
 *
 * ### Example ###
 *
 *     let value1 = RandomBoolean.nextBoolean();    // Possible result: true
 *     let value2 = RandomBoolean.chance(1,3);      // Possible result: false
 */
var RandomBoolean = /** @class */ (function () {
    function RandomBoolean() {
    }
    /**
     * Calculates "chance" out of "max chances".
     * Example: 1 chance out of 3 chances (or 33.3%)
     *
     * @param chance       a chance proportional to maxChances.
     * @param maxChances   a maximum number of chances
     */
    RandomBoolean.chance = function (chance, maxChances) {
        chance = chance >= 0 ? chance : 0;
        maxChances = maxChances >= 0 ? maxChances : 0;
        if (chance == 0 && maxChances == 0)
            return false;
        maxChances = Math.max(maxChances, chance);
        var start = (maxChances - chance) / 2;
        var end = start + chance;
        var hit = Math.random() * maxChances;
        return hit >= start && hit <= end;
    };
    /**
     * Generates a random boolean value.
     *
     * @returns a random boolean.
     */
    RandomBoolean.nextBoolean = function () {
        return Math.random() * 100 < 50;
    };
    return RandomBoolean;
}());
exports.RandomBoolean = RandomBoolean;
//# sourceMappingURL=RandomBoolean.js.map