Dogfalo/materialize · error · Error

noUiSlider: 'range' 'min' and 'max' cannot be equal.

Error message

noUiSlider: 'range' 'min' and 'max' cannot be equal.

What it means

Thrown by testRange when entry.min === entry.max. The slider needs a non-zero span to map values to positions; equal endpoints collapse every value to the same point and would divide by zero in the percentage math downstream.

Source

Thrown at extras/noUiSlider/nouislider.js:488

        // for linear sliders. Overwritten if set in 'range'.
        parsed.singleStep = entry;
    }

    function testRange ( parsed, entry ) {

        // Filter incorrect input.
        if ( typeof entry !== 'object' || Array.isArray(entry) ) {
            throw new Error("noUiSlider: 'range' is not an object.");
        }

        // Catch missing start or end.
        if ( entry.min === undefined || entry.max === undefined ) {
            throw new Error("noUiSlider: Missing 'min' or 'max' in 'range'.");
        }

        // Catch equal start or end.
        if ( entry.min === entry.max ) {
            throw new Error("noUiSlider: 'range' 'min' and 'max' cannot be equal.");
        }

        parsed.spectrum = new Spectrum(entry, parsed.snap, parsed.dir, parsed.singleStep);
    }

    function testStart ( parsed, entry ) {

        entry = asArray(entry);

        // Validate input. Values aren't tested, as the public .val method
        // will always provide a valid location.
        if ( !Array.isArray( entry ) || !entry.length ) {
            throw new Error("noUiSlider: 'start' option is incorrect.");
        }

        // Store the number of handles.
        parsed.handles = entry.length;

View on GitHub (pinned to 824e78248b)

Solutions

1. Ensure max is strictly greater than min.
2. If data may be degenerate, expand the span: max = Math.max(min + 1, max).
3. Defer noUiSlider.create until bounds actually differ.

Example fix

// before
range: { min: v, max: v }
// after
range: { min: v, max: v + span }

if (opts.range.min === opts.range.max) {
  throw new Error('range min and max must differ');
}

try { noUiSlider.create(el, opts); }
catch (e) { if (/cannot be equal/.test(e.message)) { opts.range.max = opts.range.min + 1; /* retry */ } else throw e; }

When it happens

Trigger: range: { min: 50, max: 50 }, dynamic config where both bounds resolve to the same number, or both defaulting to 0 before real data loads.

Common situations: Degenerate datasets with a single distinct value used for both bounds, an off-by-one in bound computation, or initializing the slider before the data range is known.

Related errors

• noUiSlider: 'range' contains invalid value.
• noUiSlider: 'range' value isn't numeric.
• noUiSlider: 'range' is not an object.
• noUiSlider: Missing 'min' or 'max' in 'range'.
• noUiSlider: 'limit', 'margin' and 'padding' must be divisibl

AI-assisted analysis of Dogfalo/materialize@824e78248b (2026-08-13). Data as JSON: /api/errors/5a5684b694dd8bf9. Report an issue: GitHub.