$A.util.format removed by LockerService

Question

With LockerService activated, $A.util.format is no longer available, whereas it is in the official documentation.

https://developer.salesforce.com/docs/atlas.en-us.lightning.meta/lightning/labels_dynamic.htm , paragraph "Dynamically Replacing Label Parameters"

Dear SalesForce, please could you correct that ?

Many thanks & best regards

Answer 1

$A.util.format() was never marked @platform and as such was never meant to be exposed - LS only publishes supported APIs. The documentation in question was adapted from the open source Aura project and should not have referenced $A.util.format() wrt Lightning Platform.

We are discussing this now - and as soon as I get confirmation that the Aura Framework team is signed up to support this as a public API we will get it exposed in Locker.

Answer 2

No server call is required:

$A.util.format("Hello {0}!", "world")  

is equivalent to

"Hello {0}!".replace("{0}","world")

Even a variation of Crockford's supplant method can be used:

function supplant(s, o) {
    return typeof s === 'string' && s.replace(
        /\{([^{}]*)\}/g,
        function (a, b) {
            var r = o[b];
            return typeof r === 'string' || typeof r === 'number' ? r : a;
        }
    );
}

Use it with an array or replacements:

supplant("Hello {0}!", ["world"])