webidl icon indicating copy to clipboard operation
webidl copied to clipboard

CreateBuiltinFunction’s signature has changed

Open bathos opened this issue 3 years ago • 6 comments

ECMA-262 changed the signature of the CreateBuiltinFunction abstract op last year. Perhaps there were changes on both sides around the same time or something, though, since the PR says it “preserves compatibility for WebIDL,” but it seems all 30 usages in Web IDL are incorrect now.

PREVIOUS SIGNATURE: ( steps, internalSlotsList [ , realm [ , prototype ] ] )
CURRENT SIGNATURE:  ( behaviour, length, name, additionalInternalSlotsList [ , realm [ , prototype [ , prefix ] ] ] )

Web IDL usages all look like one of these:

CreateBuiltinFunction(steps, « [[Unforgeables]] », realm, constructorProto).
CreateBuiltinFunction(steps, « », realm)
CreateBuiltinFunction(steps, « »)

Explicit names and lengths are required. In cases where Web IDL is already setting them afterwards, it’d just become a single call:

// ...where it’s currently like this:
Let F be ! CreateBuiltinFunction(steps, « », realm).
Perform ! SetFunctionName(F, id).
Perform ! SetFunctionLength(F, 0).

// ...it should be like this:
Let F be ! CreateBuiltinFunction(steps, 0, id, « », realm).

Web IDL doesn’t always set a name or length, though. I’m not certain what’s right for those cases, but it looks like they’re all Promise-related and mirror patterns in ECMA-262. Since the ES versions already use the new signature, it’s likely their values (e.g. empty string for name) are what’s wanted here, too.

(Possibly of interest to @ExE-Boss, the boss of ExEs.)

bathos avatar Feb 22 '22 01:02 bathos

Oh, I’d only searched issues earlier and missed that there’s an open PR meant to address this (which is from the same time, explaining the comment). I suppose it makes sense to leave the issue open though as it’s still pending.

bathos avatar Feb 22 '22 02:02 bathos

Yes, unfortunately that PR is blocked on https://github.com/whatwg/sg/issues/93. A replacement PR would be very welcome.

domenic avatar Feb 22 '22 15:02 domenic

Oof. Funny enough, that means I also can’t contribute PRs to Web IDL now. I’ve had my name since I was a child, but it isn’t the name printed on my birth certificate. Unfortunate that this policy disproportionately prevents people belonging to specific demographic groups from participating.

bathos avatar Feb 22 '22 15:02 bathos

As long as you are willing to enter the name you sign legal contracts with, into a form on the internet, you are able to fill out the participant agreement.

domenic avatar Feb 22 '22 15:02 domenic

Would that name appear in the public https://github.com/whatwg/participant-data/blob/main/individuals.json? It seemed like you had a good solution in that thread (a distinct participant-data-private), but it wasn’t clear to me that it had been adopted.

bathos avatar Feb 22 '22 15:02 bathos

Yes, it would appear publicly. If that's not acceptable then indeed you too are stuck :(

domenic avatar Feb 22 '22 16:02 domenic