The track's CaptureHandle at the time the event was fired, as observable by the capturing application. If not observable by the capturing application, all of CaptureHandle's fields will be set to their default value - the empty DOMString.
It makes more sense to return the exact same CaptureHandle as would a call to MediaStreamTrack.getCaptureHandle(). When there is no observable CaptureHandle, that means returning null. So:
The track's CaptureHandle at the time the event was fired, as observable by the capturing application. If not observable by the capturing application, returns null, as MediaStreamTrack.getCaptureHandle() does.
--
Noteworthy - there's a discussion on issue #50 over a suggestion to strip captureHandle() out of the event altogether. If that proposal is adopted, the current discussion would be rendered moot. However, until we settle that particular discussion, it makes sense to perform a localized fix here.
The spec currently reads:
It makes more sense to return the exact same CaptureHandle as would a call to MediaStreamTrack.getCaptureHandle(). When there is no observable CaptureHandle, that means returning
null
. So:--
Noteworthy - there's a discussion on issue #50 over a suggestion to strip
captureHandle()
out of the event altogether. If that proposal is adopted, the current discussion would be rendered moot. However, until we settle that particular discussion, it makes sense to perform a localized fix here.