Reflect.construct(): newTarget description incorrectly refers to the prototype of the constructor

[ajvincent]

MDN URL

https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Reflect/construct#newtarget

What specific section or headline is this issue about?

Parameters: newTarget

What information was incorrect, unhelpful, or incomplete?

"which usually specifies the prototype of the returned object." - this is incorrect.

What did you expect to see?

Something along the lines of "the function you called new with".

Do you have any supporting links, references, or citations?

• new.target on MDN
• test-262 tests for Reflect.construct() using functions
• a test I wrote for Reflect.construct() using classes and proxies

Do you have anything more you want to share?

No response

[Josh-Cena]

So I think "the value of new.target" sufficiently captures all the guaranteed semantics about this parameter, and anything else after it is just us trying to be helpful and talking about what happens in the general case. Normally object creation uses new.target.prototype as the prototype so this is certainly not wrong, but I would not be opposed to changing it to your suggestion.

[ajvincent]

FYI, I had to rewrite my construct-trap test for more clarity as to how it works.
https://github.com/ajvincent/es-membrane/blob/622d22bbbbb1f5263e6397f80cc2605df0b48b74/_00_ecma_references/spec/constructTrap.ts#L83

[Josh-Cena]

Feel free to send a PR btw and we can discuss the wording, but I think your suggestion looks good.