You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
util.format('%s', o) fails to call String(o) in certain cases #30333
Platform: Darwin [redacted] 18.7.0 Darwin Kernel Version 18.7.0: Sat Oct 12 00:02:19 PDT 2019; root:xnu-4903.278.12~1/RELEASE_X86_64 x86_64
Subsystem: util
I was very surprised to discover that in node v12, util.format('%s', v) does not consistently call String(v). Checking the docs, I read:
%s: String will be used to convert all values except BigInt, Object and -0. BigInt values will be represented with an n and Objects that have no user defined toString function are inspected using util.inspect() with options { depth: 0, colors: false, compact: 3 }.
This is a surprising (and in my view undesirable) change from the previous behaviour, which was to consistently call String in response to %s. It also appears to be a semantically breaking change introduced, via #27621 and #27799, in 12.3.0, despite that not being a new major version. If so, it should be entirely reverted (and good riddance, in my opinion).
If there is some compelling argument for why the new behaviour is actually desirable, then at least the code should be made consistent with the documentation or vice versa.
In particular, whether a user defined toString function is called depends in non-documented and non-obvious ways on the value of the .constructor property of the object, which is otherwise normally of no significance:
// ES6 subclassing:classA{toString(){return'custom A';}}classBextendsA{}// ES5 subclassing:functionC(){}C.prototype.toString=function(){return'custom C';};functionD(){C.call(this);}D.prototype=Object.create(C.prototype);// What if we forget to set the .constructor?// D.prototype.constructor = D;console.log('%s',newA());console.log('%s',newB());console.log('%s',newC());console.log('%s',newD());// Fix forgotten .constructor:D.prototype.constructor=D;console.log('%s',newD());
Actual output:
custom A
B {}
custom C
custom C
D {}
Expected / documented output:
custom A
custom A
custom C
custom C
custom C
Consistently applying the documented behaviour would go some way to remedying the breaking nature of this change, since at least user supplied .toString implementations would always be called, as was previously the case.
@cpcallen thank you for the bug report! This is indeed not intended and it seems like we are missing a couple of test cases (so thank you very much for highlighting the different solutions).
Activity
Node.js util.format('%s') breaking change bug
BridgeAR commentedon Nov 8, 2019
@cpcallen thank you for the bug report! This is indeed not intended and it seems like we are missing a couple of test cases (so thank you very much for highlighting the different solutions).
I will have a look at it next week.
himself65 commentedon Nov 15, 2019
It's okay on
node v10.17.0and the same problem onv13.1.0cpcallen commentedon Nov 15, 2019
Yes; as noted above it was introduced in
v12.3.0.Work around util.format bug
Work around util.format bug
Work around util.format bug
Work around util.format bug
util: fix .format() not always calling toString when it should be
util: fix .format() not always calling toString when it should be
util: fix .format() not always calling toString when it should be