[js-api] @@toStringTag values

[binji]

Associated values for the @@toStringTag well-known symbol were originally added to the design repo here.

It seems we never added these to the js-api spec, though there is a reference to @@toStringTag here. The last reference seems to be the initial check-in in #591.

Was this an accidental omission? @littledan, do you know?

[littledan]

These are defined by the WebIDL specification to be values like "WebAssembly.Memory". Was that the intention?

[binji]

Yes, that's the intention. It wasn't clear to me (and in https://bugs.chromium.org/p/v8/issues/detail?id=9265), but if this is otherwise well-known then there probably doesn't need to be any fix here.

[binji]

Hm, actually -- where is this defined? I see https://heycam.github.io/webidl/#ecmascript-binding, but it seems to require a "class string" definition.

[littledan]

The class string of a platform object that implements one or more interfaces must be the qualified name of the primary interface of the platform object

[littledan]

There is, unfortunately, an open debate about how @@toStringTag should work. I like @domenic's PR at whatwg/webidl#357 , and it matches the old specification. I would personally suggest that folks stick with those semantics while we work things out on the WebIDL side.

[binji]

Ah, I see. Thanks! OK, I think we should close this then.