Represent BufferSource and ArrayBufferView as ordinary IDL typedefs over their underlying union types, instead of special casing in the IDL generator. This allows the union conversion/return machinery handle these types consistently with other typedefs, which removes buffer specific paths from the IDL generator. This necessitates changing the WebIDL::BufferSource and WebIDL::ArrayBufferView classes as views over these variants. This replaces the old GC backed BufferableObject wrapper structure and provide convenience helpers to determine things such as the byte length, byte offset, backing buffer, and typed-array APIs.
69 lines
2.3 KiB
C++
69 lines
2.3 KiB
C++
/*
|
|
* Copyright (c) 2023, Matthew Olsson <mattco@serenityos.org>
|
|
* Copyright (c) 2023, Shannon Booth <shannon@serenityos.org>
|
|
*
|
|
* SPDX-License-Identifier: BSD-2-Clause
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <AK/Forward.h>
|
|
#include <AK/Function.h>
|
|
#include <LibJS/Forward.h>
|
|
#include <LibWeb/Bindings/PlatformObject.h>
|
|
#include <LibWeb/Bindings/ReadableStreamBYOBReader.h>
|
|
#include <LibWeb/Forward.h>
|
|
#include <LibWeb/Streams/ReadableStreamGenericReader.h>
|
|
#include <LibWeb/WebIDL/Buffers.h>
|
|
#include <LibWeb/WebIDL/Types.h>
|
|
|
|
namespace Web::Streams {
|
|
|
|
// https://streams.spec.whatwg.org/#read-into-request
|
|
class ReadIntoRequest : public JS::Cell {
|
|
GC_CELL(ReadIntoRequest, JS::Cell);
|
|
|
|
public:
|
|
virtual ~ReadIntoRequest() = default;
|
|
|
|
// An algorithm taking a chunk, called when a chunk is available for reading
|
|
virtual void on_chunk(JS::Value chunk) = 0;
|
|
|
|
// An algorithm taking a chunk or undefined, called when no chunks are available because the stream is closed
|
|
virtual void on_close(JS::Value chunk_or_undefined) = 0;
|
|
|
|
// An algorithm taking a JavaScript value, called when no chunks are available because the stream is errored
|
|
virtual void on_error(JS::Value error) = 0;
|
|
};
|
|
|
|
// https://streams.spec.whatwg.org/#readablestreambyobreader
|
|
class ReadableStreamBYOBReader final
|
|
: public Bindings::PlatformObject
|
|
, public ReadableStreamGenericReaderMixin {
|
|
WEB_PLATFORM_OBJECT(ReadableStreamBYOBReader, Bindings::PlatformObject);
|
|
GC_DECLARE_ALLOCATOR(ReadableStreamBYOBReader);
|
|
|
|
public:
|
|
static WebIDL::ExceptionOr<GC::Ref<ReadableStreamBYOBReader>> construct_impl(JS::Realm&, GC::Ref<ReadableStream>);
|
|
|
|
virtual ~ReadableStreamBYOBReader() override = default;
|
|
|
|
GC::Ref<WebIDL::Promise> read(WebIDL::ArrayBufferView, Bindings::ReadableStreamBYOBReaderReadOptions options = {});
|
|
|
|
void release_lock();
|
|
|
|
Vector<GC::Ref<ReadIntoRequest>>& read_into_requests() { return m_read_into_requests; }
|
|
|
|
private:
|
|
explicit ReadableStreamBYOBReader(JS::Realm&);
|
|
|
|
virtual void initialize(JS::Realm&) override;
|
|
|
|
virtual void visit_edges(Cell::Visitor&) override;
|
|
|
|
// https://streams.spec.whatwg.org/#readablestreambyobreader-readintorequests
|
|
// A list of read-into requests, used when a consumer requests chunks sooner than they are available
|
|
Vector<GC::Ref<ReadIntoRequest>> m_read_into_requests;
|
|
};
|
|
|
|
}
|