ladybird/Libraries/LibWeb/Fetch/Body.h

75 lines
2.3 KiB
C++

/*
* Copyright (c) 2022-2023, Linus Groh <linusg@serenityos.org>
* Copyright (c) 2024, Jamie Mansfield <jmansfield@cadixdev.org>
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#pragma once
#include <AK/Forward.h>
#include <AK/HashMap.h>
#include <AK/Optional.h>
#include <AK/String.h>
#include <LibGC/Ptr.h>
#include <LibJS/Forward.h>
#include <LibWeb/Forward.h>
namespace Web::Fetch {
enum class PackageDataType {
ArrayBuffer,
Blob,
Uint8Array,
FormData,
JSON,
Text,
};
struct MultiPartFormDataHeader {
Optional<String> name;
Optional<String> filename;
Optional<String> content_type;
};
struct ContentDispositionHeader {
String type;
OrderedHashMap<String, String> parameters;
};
struct MultipartParsingError {
String message;
};
template<typename T>
using MultipartParsingErrorOr = ErrorOr<T, MultipartParsingError>;
// https://fetch.spec.whatwg.org/#body-mixin
class BodyMixin {
public:
virtual ~BodyMixin();
virtual Optional<MimeSniff::MimeType> mime_type_impl() const = 0;
virtual GC::Ptr<Infrastructure::Body> body_impl() = 0;
virtual GC::Ptr<Infrastructure::Body const> body_impl() const = 0;
virtual Bindings::PlatformObject& as_platform_object() = 0;
virtual Bindings::PlatformObject const& as_platform_object() const = 0;
[[nodiscard]] bool is_unusable() const;
[[nodiscard]] GC::Ptr<Streams::ReadableStream> body() const;
[[nodiscard]] bool body_used() const;
// JS API functions
[[nodiscard]] WebIDL::ExceptionOr<GC::Ref<WebIDL::Promise>> array_buffer() const;
[[nodiscard]] WebIDL::ExceptionOr<GC::Ref<WebIDL::Promise>> blob() const;
[[nodiscard]] WebIDL::ExceptionOr<GC::Ref<WebIDL::Promise>> bytes() const;
[[nodiscard]] WebIDL::ExceptionOr<GC::Ref<WebIDL::Promise>> form_data() const;
[[nodiscard]] WebIDL::ExceptionOr<GC::Ref<WebIDL::Promise>> json() const;
[[nodiscard]] WebIDL::ExceptionOr<GC::Ref<WebIDL::Promise>> text() const;
};
[[nodiscard]] WebIDL::ExceptionOr<JS::Value> package_data(JS::Realm&, ByteBuffer, PackageDataType, Optional<MimeSniff::MimeType> const&);
[[nodiscard]] WebIDL::ExceptionOr<GC::Ref<WebIDL::Promise>> consume_body(JS::Realm&, BodyMixin const&, PackageDataType);
[[nodiscard]] MultipartParsingErrorOr<Vector<XHR::FormDataEntry>> parse_multipart_form_data(JS::Realm&, StringView input, MimeSniff::MimeType const& mime_type);
}