DefinitelyTyped/types/k6/metrics.d.ts

/*
 * Custom metrics.
 * https://k6.io/docs/javascript-api/k6-metrics
 */

/**
 * Custom metric.
 */
export abstract class Metric {
    protected __brand: never;

    /**
     * @param name - Metric name.
     * @param isTime - Whether values are time values.
     */
    constructor(name: string, isTime?: boolean);

    /**
     * Add value.
     * @param value - Value to add.
     * @param tags - Tags to attach to data point.
     */
    add(value: number | boolean, tags?: { [name: string]: string }): void;
}

/**
 * Cumulative counter.
 * https://k6.io/docs/javascript-api/k6-metrics/counter-k6-metrics
 *
 * @example
 * // Create instance on init context
 * const myCounter = new Counter('metricName');
 * export default function() {
 *   myCounter.add(1);
 * }
 */
export class Counter extends Metric {
    protected __brand: never;
}

/**
 * Gauge. Holds only latest value.
 * https://k6.io/docs/javascript-api/k6-metrics/gauge-k6-metrics
 */
export class Gauge extends Metric {
    protected __brand: never;
}

/**
 * Tracks percentage of nonzero values.
 * https://k6.io/docs/javascript-api/k6-metrics/rate-k6-metrics
 */
export class Rate extends Metric {
    protected __brand: never;
}

/**
 * Calculates summary statistics.
 * https://k6.io/docs/javascript-api/k6-metrics/trend-k6-metrics
 */
export class Trend extends Metric {
    protected __brand: never;
}