mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-10-24 08:59:50 +00:00
2c3531ab78
This change also removes as much direct use of JS::Promise in LibWeb as possible. When specs refer to `Promise<T>` they should be assumed to be referring to the WebIDL Promise type, not the JS::Promise type. The one exception is the HostPromiseRejectionTracker hook on the JS VM. This facility and its associated sets and events are intended to expose the exact opaque object handles that were rejected to author code. This is not possible with the WebIDL Promise type, so we have to use JS::Promise or JS::Object to hold onto the promises. It also exposes which specs need some updates in the area of promises. WebDriver stands out in this regard. WebAudio could use some more cross-references to WebIDL as well to clarify things.
72 lines
2.4 KiB
C++
72 lines
2.4 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/Forward.h>
|
|
#include <LibWeb/Streams/ReadableStreamGenericReader.h>
|
|
#include <LibWeb/WebIDL/Types.h>
|
|
|
|
namespace Web::Streams {
|
|
|
|
// https://streams.spec.whatwg.org/#dictdef-readablestreambyobreaderreadoptions
|
|
struct ReadableStreamBYOBReaderReadOptions {
|
|
WebIDL::UnsignedLongLong min = 1;
|
|
};
|
|
|
|
// https://streams.spec.whatwg.org/#read-into-request
|
|
class ReadIntoRequest : public JS::Cell {
|
|
JS_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);
|
|
JS_DECLARE_ALLOCATOR(ReadableStreamBYOBReader);
|
|
|
|
public:
|
|
static WebIDL::ExceptionOr<JS::NonnullGCPtr<ReadableStreamBYOBReader>> construct_impl(JS::Realm&, JS::NonnullGCPtr<ReadableStream>);
|
|
|
|
virtual ~ReadableStreamBYOBReader() override = default;
|
|
|
|
JS::NonnullGCPtr<WebIDL::Promise> read(JS::Handle<WebIDL::ArrayBufferView>&, ReadableStreamBYOBReaderReadOptions options = {});
|
|
|
|
void release_lock();
|
|
|
|
Vector<JS::NonnullGCPtr<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<JS::NonnullGCPtr<ReadIntoRequest>> m_read_into_requests;
|
|
};
|
|
|
|
}
|