{"action":"opened","issue":{"url":"https://api.github.com/repos/dart-lang/sdk/issues/30795","repository_url":"https://api.github.com/repos/dart-lang/sdk","labels_url":"https://api.github.com/repos/dart-lang/sdk/issues/30795/labels{/name}","comments_url":"https://api.github.com/repos/dart-lang/sdk/issues/30795/comments","events_url":"https://api.github.com/repos/dart-lang/sdk/issues/30795/events","html_url":"https://github.com/dart-lang/sdk/issues/30795","id":258757457,"number":30795,"title":"Please, clarify WebSocket description","user":{"login":"alsemenov","id":4629015,"avatar_url":"https://avatars2.githubusercontent.com/u/4629015?v=4","gravatar_id":"","url":"https://api.github.com/users/alsemenov","html_url":"https://github.com/alsemenov","followers_url":"https://api.github.com/users/alsemenov/followers","following_url":"https://api.github.com/users/alsemenov/following{/other_user}","gists_url":"https://api.github.com/users/alsemenov/gists{/gist_id}","starred_url":"https://api.github.com/users/alsemenov/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/alsemenov/subscriptions","organizations_url":"https://api.github.com/users/alsemenov/orgs","repos_url":"https://api.github.com/users/alsemenov/repos","events_url":"https://api.github.com/users/alsemenov/events{/privacy}","received_events_url":"https://api.github.com/users/alsemenov/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"assignees":[],"milestone":null,"comments":0,"created_at":"2017-09-19T09:38:35Z","updated_at":"2017-09-19T09:38:35Z","closed_at":null,"author_association":"CONTRIBUTOR","body":"Current [description](https://api.dartlang.org/stable/1.24.2/dart-io/WebSocket-class.html) for class dart:io:WebSocket is quite short.\r\nPlease, specify the following:\r\n\r\n- The WebSockets specification and version (probably some draft) which is implemented by dart:io:WebSocket class. This is important for heterogeneous communications. The other side (which might be not Dart) should know what expect.\r\n- Which protocols and extensions are supported?\r\n- Whether messages (especially `List<int>`) are transfered without splitting or joining with another messages\r\n- The WebSocket life cycle, like `readyState` (?) is `CONNECTING` after call to `connect`, `OPEN` after future returned by `connect` completes, etc. (BTW `CONNECTING` seems to be redundant in this case). \r\n- How the `readyState` of paired instance is affected, when WebSocket is closed or closing\r\n- If `done` event is received on WebSocket (which implements Stream) is it necessary to `close` the WebSocket explicitly?\r\n- Will peer instance receive `done` event after call to `close`?\r\n"}}
{"actor":{"display_login":"alsemenov"}}