/* * Copyright (c) 2022-2023, Linus Groh * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web::Fetch { BodyMixin::~BodyMixin() = default; // https://fetch.spec.whatwg.org/#body-unusable bool BodyMixin::is_unusable() const { // An object including the Body interface mixin is said to be unusable if its body is non-null and its body’s stream is disturbed or locked. auto const& body = body_impl(); return body && (body->stream()->is_disturbed() || body->stream()->is_locked()); } // https://fetch.spec.whatwg.org/#dom-body-body JS::GCPtr BodyMixin::body() const { // The body getter steps are to return null if this’s body is null; otherwise this’s body’s stream. auto const& body = body_impl(); return body ? body->stream().ptr() : nullptr; } // https://fetch.spec.whatwg.org/#dom-body-bodyused bool BodyMixin::body_used() const { // The bodyUsed getter steps are to return true if this’s body is non-null and this’s body’s stream is disturbed; otherwise false. auto const& body = body_impl(); return body && body->stream()->is_disturbed(); } // https://fetch.spec.whatwg.org/#dom-body-arraybuffer WebIDL::ExceptionOr> BodyMixin::array_buffer() const { auto& vm = Bindings::main_thread_vm(); auto& realm = *vm.current_realm(); // The arrayBuffer() method steps are to return the result of running consume body with this and ArrayBuffer. return consume_body(realm, *this, PackageDataType::ArrayBuffer); } // https://fetch.spec.whatwg.org/#dom-body-blob WebIDL::ExceptionOr> BodyMixin::blob() const { auto& vm = Bindings::main_thread_vm(); auto& realm = *vm.current_realm(); // The blob() method steps are to return the result of running consume body with this and Blob. return consume_body(realm, *this, PackageDataType::Blob); } // https://fetch.spec.whatwg.org/#dom-body-formdata WebIDL::ExceptionOr> BodyMixin::form_data() const { auto& vm = Bindings::main_thread_vm(); auto& realm = *vm.current_realm(); // The formData() method steps are to return the result of running consume body with this and FormData. return consume_body(realm, *this, PackageDataType::FormData); } // https://fetch.spec.whatwg.org/#dom-body-json WebIDL::ExceptionOr> BodyMixin::json() const { auto& vm = Bindings::main_thread_vm(); auto& realm = *vm.current_realm(); // The json() method steps are to return the result of running consume body with this and JSON. return consume_body(realm, *this, PackageDataType::JSON); } // https://fetch.spec.whatwg.org/#dom-body-text WebIDL::ExceptionOr> BodyMixin::text() const { auto& vm = Bindings::main_thread_vm(); auto& realm = *vm.current_realm(); // The text() method steps are to return the result of running consume body with this and text. return consume_body(realm, *this, PackageDataType::Text); } // https://fetch.spec.whatwg.org/#concept-body-package-data WebIDL::ExceptionOr package_data(JS::Realm& realm, ByteBuffer bytes, PackageDataType type, Optional const& mime_type) { auto& vm = realm.vm(); switch (type) { case PackageDataType::ArrayBuffer: // Return a new ArrayBuffer whose contents are bytes. return JS::ArrayBuffer::create(realm, move(bytes)); case PackageDataType::Blob: { // Return a Blob whose contents are bytes and type attribute is mimeType. // NOTE: If extracting the mime type returns failure, other browsers set it to an empty string - not sure if that's spec'd. auto mime_type_string = mime_type.has_value() ? MUST(mime_type->serialized()) : String {}; return FileAPI::Blob::create(realm, move(bytes), move(mime_type_string)); } case PackageDataType::FormData: // If mimeType’s essence is "multipart/form-data", then: if (mime_type.has_value() && mime_type->essence() == "multipart/form-data"sv) { // FIXME: 1. Parse bytes, using the value of the `boundary` parameter from mimeType, per the rules set forth in Returning Values from Forms: multipart/form-data. [RFC7578] // FIXME: 2. If that fails for some reason, then throw a TypeError. // FIXME: 3. Return a new FormData object, appending each entry, resulting from the parsing operation, to its entry list. return JS::js_null(); } // Otherwise, if mimeType’s essence is "application/x-www-form-urlencoded", then: else if (mime_type.has_value() && mime_type->essence() == "application/x-www-form-urlencoded"sv) { // FIXME: 1. Let entries be the result of parsing bytes. // FIXME: 2. If entries is failure, then throw a TypeError. // FIXME: 3. Return a new FormData object whose entry list is entries. return JS::js_null(); } // Otherwise, throw a TypeError. else { return WebIDL::SimpleException { WebIDL::SimpleExceptionType::TypeError, "Mime type must be 'multipart/form-data' or 'application/x-www-form-urlencoded'"sv }; } case PackageDataType::JSON: // Return the result of running parse JSON from bytes on bytes. return Infra::parse_json_bytes_to_javascript_value(realm, bytes); case PackageDataType::Text: { // Return the result of running UTF-8 decode on bytes. auto decoder = TextCodec::decoder_for("UTF-8"sv); VERIFY(decoder.has_value()); auto utf8_text = MUST(TextCodec::convert_input_to_utf8_using_given_decoder_unless_there_is_a_byte_order_mark(*decoder, bytes)); return JS::PrimitiveString::create(vm, move(utf8_text)); } default: VERIFY_NOT_REACHED(); } } // https://fetch.spec.whatwg.org/#concept-body-consume-body WebIDL::ExceptionOr> consume_body(JS::Realm& realm, BodyMixin const& object, PackageDataType type) { // 1. If object is unusable, then return a promise rejected with a TypeError. if (object.is_unusable()) { WebIDL::SimpleException exception { WebIDL::SimpleExceptionType::TypeError, "Body is unusable"sv }; return WebIDL::create_rejected_promise_from_exception(realm, move(exception)); } // 2. Let promise be a new promise. auto promise = WebIDL::create_promise(realm); // 3. Let errorSteps given error be to reject promise with error. // NOTE: `promise` and `realm` is protected by JS::SafeFunction. auto error_steps = JS::create_heap_function(realm.heap(), [promise, &realm](JS::GCPtr error) { // AD-HOC: An execution context is required for Promise's reject function. HTML::TemporaryExecutionContext execution_context { Bindings::host_defined_environment_settings_object(realm) }; WebIDL::reject_promise(realm, promise, error); }); // 4. Let successSteps given a byte sequence data be to resolve promise with the result of running convertBytesToJSValue // with data. If that threw an exception, then run errorSteps with that exception. // NOTE: `promise`, `realm` and `object` is protected by JS::SafeFunction. // FIXME: Refactor this to the new version of the spec introduced with https://github.com/whatwg/fetch/commit/464326e8eb6a602122c030cd40042480a3c0e265 auto success_steps = JS::create_heap_function(realm.heap(), [promise, &realm, &object, type](ByteBuffer data) { auto& vm = realm.vm(); // AD-HOC: An execution context is required for Promise's reject function and JSON.parse. HTML::TemporaryExecutionContext execution_context { Bindings::host_defined_environment_settings_object(realm) }; auto value_or_error = Bindings::throw_dom_exception_if_needed(vm, [&]() -> WebIDL::ExceptionOr { return package_data(realm, data, type, object.mime_type_impl()); }); if (value_or_error.is_error()) { // We can't call error_steps here without moving it into success_steps, causing a double move when we pause error_steps // to fully_read, so just reject the promise like error_steps does. WebIDL::reject_promise(realm, promise, value_or_error.release_error().value().value()); return; } WebIDL::resolve_promise(realm, promise, value_or_error.release_value()); }); // 5. If object’s body is null, then run successSteps with an empty byte sequence. auto const& body = object.body_impl(); if (!body) { success_steps->function()(ByteBuffer {}); } // 6. Otherwise, fully read object’s body given successSteps, errorSteps, and object’s relevant global object. else { body->fully_read(realm, success_steps, error_steps, JS::NonnullGCPtr { HTML::relevant_global_object(object.as_platform_object()) }); } // 7. Return promise. return JS::NonnullGCPtr { verify_cast(*promise->promise().ptr()) }; } }