whatwg / webidl

Web IDL Standard
https://webidl.spec.whatwg.org/
Other
405 stars 162 forks source link

CreateBuiltinFunction’s signature has changed #1106

Open bathos opened 2 years ago

bathos commented 2 years ago

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 commented 2 years ago

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.

domenic commented 2 years ago

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

bathos commented 2 years ago

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.

domenic commented 2 years ago

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.

bathos commented 2 years ago

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.

domenic commented 2 years ago

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