Run results for: collatorCompare() vs agGridComparator()

Run details:

User agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/124.0.0.0 Safari/537.36

Browser: Chrome 124

Operating system: Mac OS X 10.15.7

Device Platform: Desktop

Date tested: 29 days ago

Test name	Executions per second
agGridComparator()	9569837.0 Ops/sec
collatorCompare()	3064938.0 Ops/sec

Script Preparation code:

var a = "FOO BAR";
var b = "foo bar";

var options = {
    numeric: true
};

var collator = new Intl.Collator('en', options);

function collatorCompare(valueA, valueB) {
    const valueAMissing = valueA == null || valueA == undefined;
    const valueBMissing = valueB == null || valueB == undefined;

    if (valueA === valueB) {
        return 0
    } else if (valueAMissing) {
        return -1
    } else if (valueBMissing) {
    	return 1
	}

	return collator.compare(valueA, valueB)
}

function agGridComparator(valueA, valueB, accentedCompare = false) {
    const valueAMissing = valueA == null;
    const valueBMissing = valueB == null;

    // this is for aggregations sum and avg, where the result can be a number that is wrapped.
    // if we didn't do this, then the toString() value would be used, which would result in
    // the strings getting used instead of the numbers.
    if (valueA && valueA.toNumber) {
        valueA = valueA.toNumber();
    }

    if (valueB && valueB.toNumber) {
        valueB = valueB.toNumber();
    }

    if (valueAMissing && valueBMissing) {
        return 0;
    }

    if (valueAMissing) {
        return -1;
    }

    if (valueBMissing) {
        return 1;
    }

    function doQuickCompare(a, b) {
        return (a > b ? 1 : (a < b ? -1 : 0));
    }

    if (typeof valueA !== 'string') {
        return doQuickCompare(valueA, valueB);
    }

    if (!accentedCompare) {
        return doQuickCompare(valueA, valueB);
    }

    try {
        // using local compare also allows chinese comparisons
        return valueA.localeCompare(valueB);
    } catch (e) {
        // if something wrong with localeCompare, eg not supported
        // by browser, then just continue with the quick one
        return doQuickCompare(valueA, valueB);
    }
}

Tests:

agGridComparator()
agGridComparator(a,b) === 0
collatorCompare()
collatorCompare(a, b) === 0