/* * Copyright (c) 2021-2022, Dex♪ * Copyright (c) 2023, Kenneth Myhra * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #define ENUMERATE_WEBSOCKET_EVENT_HANDLERS(E) \ E(onerror, HTML::EventNames::error) \ E(onclose, HTML::EventNames::close) \ E(onopen, HTML::EventNames::open) \ E(onmessage, HTML::EventNames::message) namespace Web::WebSockets { class WebSocketClientSocket; class WebSocketClientManager; class WebSocket final : public DOM::EventTarget { WEB_PLATFORM_OBJECT(WebSocket, DOM::EventTarget); JS_DECLARE_ALLOCATOR(WebSocket); public: enum class ReadyState : u16 { Connecting = 0, Open = 1, Closing = 2, Closed = 3, }; static WebIDL::ExceptionOr> construct_impl(JS::Realm&, String const& url, Optional>> const& protocols); virtual ~WebSocket() override; WebIDL::ExceptionOr url() const { return TRY_OR_THROW_OOM(vm(), m_url.to_string()); } void set_url(URL::URL url) { m_url = move(url); } #undef __ENUMERATE #define __ENUMERATE(attribute_name, event_name) \ void set_##attribute_name(WebIDL::CallbackType*); \ WebIDL::CallbackType* attribute_name(); ENUMERATE_WEBSOCKET_EVENT_HANDLERS(__ENUMERATE) #undef __ENUMERATE ReadyState ready_state() const; String extensions() const; WebIDL::ExceptionOr protocol() const; String const& binary_type() { return m_binary_type; } void set_binary_type(String const& type) { m_binary_type = type; } WebIDL::ExceptionOr close(Optional code, Optional reason); WebIDL::ExceptionOr send(Variant, JS::Handle, String> const& data); private: void on_open(); void on_message(ByteBuffer message, bool is_text); void on_error(); void on_close(u16 code, String reason, bool was_clean); WebSocket(JS::Realm&); virtual void initialize(JS::Realm&) override; ErrorOr establish_web_socket_connection(URL::URL& url_record, Vector& protocols, HTML::EnvironmentSettingsObject& client); URL::URL m_url; String m_binary_type { "blob"_string }; RefPtr m_websocket; }; class WebSocketClientSocket : public RefCounted { public: virtual ~WebSocketClientSocket(); struct CertificateAndKey { ByteString certificate; ByteString key; }; struct Message { ByteBuffer data; bool is_text { false }; }; enum class Error { CouldNotEstablishConnection, ConnectionUpgradeFailed, ServerClosedSocket, }; virtual Web::WebSockets::WebSocket::ReadyState ready_state() = 0; virtual ByteString subprotocol_in_use() = 0; virtual void send(ByteBuffer binary_or_text_message, bool is_text) = 0; virtual void send(StringView text_message) = 0; virtual void close(u16 code = 1005, ByteString reason = {}) = 0; Function on_open; Function on_message; Function on_error; Function on_close; Function on_certificate_requested; protected: explicit WebSocketClientSocket() = default; }; }