We're leaking experimental APIs

[mseddon]

It appears the WebAudio api accidentally introduced a MediaStream trait (stubbed) into scala.js.dom.raw here. This type is also forwarded in dom.

As you can see though, it's not compatible enough to meet the criteria of being outside of experimental. But sadly, we've released it in 0.8.1 and 0.8.2.

There may be others, and I will investigate.

@sjrd @lihaoyi I wonder since the next release will be 0.9.0 if we do some slightly breaking reorganization to fix up anything that slipped out? Hopefully it won't impact too many people.

#179 fleshes out the MediaStream class (because it's needed for WebRTC), but I've been afraid to move it into experimental without checking with you guys that this breaking change is acceptable.

[sjrd]

Sure, we can break things.

You can also add a deprecated forwarder in the original location.

[mseddon]

Ah, that's good- I wasn't sure if it was possible to annotate type. That makes this kind of reorg much less worrying.

[mseddon]

ServiceWorker, ServiceWorkerRegistration, ServiceWorkerContainer, all want to live in experimental.serviceworker. Fixed in #187

[mseddon]

Promise is sort of annoying- http://caniuse.com/#feat=promises since they're not present in IE11. They are in Edge, but that unfortunately doesn't mean anything to windows 7 and windows 8 users.

[sjrd]

Promise needs to go to core anyway, because it's specified in ES6 itself.

[mseddon]

EventSource is not supported in IE or Edge.

[mseddon]

That's everything I found in lib.scala. It appears WebAudio.scala in general should live in experimental, because it is not supported under IE.

[mseddon]

IndexDB is an interesting one. IE and Edge don't support some operations, and Safari's implementation is just broken. Technically it's "present" though.

Given that getBoundingClientRect happens to be broken under chrome android (it doesn't take into account viewport scroll position), I think IndexDB can probably stay.

[kapunga]

@sjrd @mseddon Is this still an issue? If it is, I'd be happy to go clean up what is left.

[mseddon]

@kapunga Thanks! The obvious one remaining I think is the WebAudio api, but if EventSource is not heavily referenced it should also be fairly trivial to migrate. I think we might as well hold off on Promise, since it will find it's way into the core Scala.js library in a future release anyway,which doesn't really distinguish 'experimental'. We might stick a warning and reference to a recommended Promise polyfill in the scala-js-dom documentation as a stop-gap measure.

[kapunga]

Okay, I'm starting work on this. From poking around the documentation, it appears that it's not the WebAudio API that is experimental, but the MediaStream API (as described here: https://www.w3.org/TR/mediacapture-streams/), correct?
The AudioNode member of the WebAudio API appears to be widely adopted: http://caniuse.com/#search=AudioNode
Whereas MediaStream does not:
http://caniuse.com/#search=MediaStream