mirror of
https://github.com/LadybirdBrowser/ladybird.git
synced 2025-07-26 02:40:22 +00:00
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.
188 lines
8.3 KiB
C++
188 lines
8.3 KiB
C++
/*
|
||
* Copyright (c) 2022-2023, Linus Groh <linusg@serenityos.org>
|
||
*
|
||
* SPDX-License-Identifier: BSD-2-Clause
|
||
*/
|
||
|
||
#include <AK/Debug.h>
|
||
#include <AK/TypeCasts.h>
|
||
#include <LibJS/Runtime/PromiseCapability.h>
|
||
#include <LibWeb/Bindings/ExceptionOrUtils.h>
|
||
#include <LibWeb/Bindings/HostDefined.h>
|
||
#include <LibWeb/DOM/AbortSignal.h>
|
||
#include <LibWeb/Fetch/FetchMethod.h>
|
||
#include <LibWeb/Fetch/Fetching/Fetching.h>
|
||
#include <LibWeb/Fetch/Fetching/RefCountedFlag.h>
|
||
#include <LibWeb/Fetch/Infrastructure/FetchAlgorithms.h>
|
||
#include <LibWeb/Fetch/Infrastructure/FetchController.h>
|
||
#include <LibWeb/Fetch/Infrastructure/HTTP/Requests.h>
|
||
#include <LibWeb/Fetch/Infrastructure/HTTP/Responses.h>
|
||
#include <LibWeb/Fetch/Request.h>
|
||
#include <LibWeb/Fetch/Response.h>
|
||
#include <LibWeb/HTML/Scripting/TemporaryExecutionContext.h>
|
||
#include <LibWeb/WebIDL/ExceptionOr.h>
|
||
#include <LibWeb/WebIDL/Promise.h>
|
||
|
||
namespace Web::Fetch {
|
||
|
||
// https://fetch.spec.whatwg.org/#dom-global-fetch
|
||
JS::NonnullGCPtr<WebIDL::Promise> fetch(JS::VM& vm, RequestInfo const& input, RequestInit const& init)
|
||
{
|
||
auto& realm = *vm.current_realm();
|
||
|
||
// 1. Let p be a new promise.
|
||
auto promise_capability = WebIDL::create_promise(realm);
|
||
|
||
// 2. Let requestObject be the result of invoking the initial value of Request as constructor with input and init
|
||
// as arguments. If this throws an exception, reject p with it and return p.
|
||
auto exception_or_request_object = Request::construct_impl(realm, input, init);
|
||
if (exception_or_request_object.is_exception()) {
|
||
auto throw_completion = Bindings::dom_exception_to_throw_completion(vm, exception_or_request_object.exception());
|
||
WebIDL::reject_promise(realm, promise_capability, *throw_completion.value());
|
||
return promise_capability;
|
||
}
|
||
auto request_object = exception_or_request_object.release_value();
|
||
|
||
// 3. Let request be requestObject’s request.
|
||
auto request = request_object->request();
|
||
|
||
// 4. If requestObject’s signal is aborted, then:
|
||
if (request_object->signal()->aborted()) {
|
||
// 1. Abort the fetch() call with p, request, null, and requestObject’s signal’s abort reason.
|
||
abort_fetch(realm, promise_capability, request, nullptr, request_object->signal()->reason());
|
||
|
||
// 2. Return p.
|
||
return promise_capability;
|
||
}
|
||
|
||
// 5. Let globalObject be request’s client’s global object.
|
||
auto& global_object = request->client()->global_object();
|
||
|
||
// FIXME: 6. If globalObject is a ServiceWorkerGlobalScope object, then set request’s service-workers mode to "none".
|
||
(void)global_object;
|
||
|
||
// 7. Let responseObject be null.
|
||
JS::GCPtr<Response> response_object;
|
||
|
||
// 8. Let relevantRealm be this’s relevant Realm.
|
||
// NOTE: This assumes that the running execution context is for the fetch() function call.
|
||
auto& relevant_realm = HTML::relevant_realm(*vm.running_execution_context().function);
|
||
|
||
// 9. Let locallyAborted be false.
|
||
// NOTE: This lets us reject promises with predictable timing, when the request to abort comes from the same thread
|
||
// as the call to fetch.
|
||
auto locally_aborted = Fetching::RefCountedFlag::create(false);
|
||
|
||
// 10. Let controller be null.
|
||
JS::GCPtr<Infrastructure::FetchController> controller;
|
||
|
||
// NOTE: Step 11 is done out of order so that the controller is non-null when we capture the GCPtr by copy in the abort algorithm lambda.
|
||
// This is not observable, AFAICT.
|
||
|
||
// 12. Set controller to the result of calling fetch given request and processResponse given response being these
|
||
// steps:
|
||
auto process_response = [locally_aborted, promise_capability, request, response_object, &relevant_realm](JS::NonnullGCPtr<Infrastructure::Response> response) mutable {
|
||
// 1. If locallyAborted is true, then abort these steps.
|
||
if (locally_aborted->value())
|
||
return;
|
||
|
||
// AD-HOC: An execution context is required for Promise functions.
|
||
HTML::TemporaryExecutionContext execution_context { Bindings::host_defined_environment_settings_object(relevant_realm) };
|
||
|
||
// 2. If response’s aborted flag is set, then:
|
||
if (response->aborted()) {
|
||
// FIXME: 1. Let deserializedError be the result of deserialize a serialized abort reason given controller’s
|
||
// serialized abort reason and relevantRealm.
|
||
auto deserialized_error = JS::js_undefined();
|
||
|
||
// 2. Abort the fetch() call with p, request, responseObject, and deserializedError.
|
||
abort_fetch(relevant_realm, promise_capability, request, response_object, deserialized_error);
|
||
|
||
// 3. Abort these steps.
|
||
return;
|
||
}
|
||
|
||
// 3. If response is a network error, then reject p with a TypeError and abort these steps.
|
||
if (response->is_network_error()) {
|
||
auto message = response->network_error_message().value_or("Response is a network error"sv);
|
||
WebIDL::reject_promise(relevant_realm, promise_capability, JS::TypeError::create(relevant_realm, message));
|
||
return;
|
||
}
|
||
|
||
// 4. Set responseObject to the result of creating a Response object, given response, "immutable", and
|
||
// relevantRealm.
|
||
response_object = Response::create(relevant_realm, response, Headers::Guard::Immutable);
|
||
|
||
// 5. Resolve p with responseObject.
|
||
WebIDL::resolve_promise(relevant_realm, promise_capability, response_object);
|
||
};
|
||
controller = MUST(Fetching::fetch(
|
||
realm,
|
||
request,
|
||
Infrastructure::FetchAlgorithms::create(vm,
|
||
{
|
||
.process_request_body_chunk_length = {},
|
||
.process_request_end_of_body = {},
|
||
.process_early_hints_response = {},
|
||
.process_response = move(process_response),
|
||
.process_response_end_of_body = {},
|
||
.process_response_consume_body = {},
|
||
})));
|
||
|
||
// 11. Add the following abort steps to requestObject’s signal:
|
||
request_object->signal()->add_abort_algorithm([locally_aborted, request, controller, promise_capability, request_object, response_object, &relevant_realm] {
|
||
dbgln_if(WEB_FETCH_DEBUG, "Fetch: Request object signal's abort algorithm called");
|
||
|
||
// 1. Set locallyAborted to true.
|
||
locally_aborted->set_value(true);
|
||
|
||
// 2. Assert: controller is non-null.
|
||
VERIFY(controller);
|
||
|
||
// 3. Abort controller with requestObject’s signal’s abort reason.
|
||
controller->abort(relevant_realm, request_object->signal()->reason());
|
||
|
||
// AD-HOC: An execution context is required for Promise functions.
|
||
HTML::TemporaryExecutionContext execution_context { Bindings::host_defined_environment_settings_object(relevant_realm) };
|
||
|
||
// 4. Abort the fetch() call with p, request, responseObject, and requestObject’s signal’s abort reason.
|
||
abort_fetch(relevant_realm, *promise_capability, request, response_object, request_object->signal()->reason());
|
||
});
|
||
|
||
// 13. Return p.
|
||
return promise_capability;
|
||
}
|
||
|
||
// https://fetch.spec.whatwg.org/#abort-fetch
|
||
void abort_fetch(JS::Realm& realm, WebIDL::Promise const& promise, JS::NonnullGCPtr<Infrastructure::Request> request, JS::GCPtr<Response> response_object, JS::Value error)
|
||
{
|
||
dbgln_if(WEB_FETCH_DEBUG, "Fetch: Aborting fetch with: request @ {}, error = {}", request.ptr(), error);
|
||
|
||
// 1. Reject promise with error.
|
||
// NOTE: This is a no-op if promise has already fulfilled.
|
||
WebIDL::reject_promise(realm, promise, error);
|
||
|
||
// 2. If request’s body is non-null and is readable, then cancel request’s body with error.
|
||
if (auto* body = request->body().get_pointer<JS::NonnullGCPtr<Infrastructure::Body>>(); body != nullptr && (*body)->stream()->is_readable()) {
|
||
// TODO: Implement cancelling streams
|
||
(void)error;
|
||
}
|
||
|
||
// 3. If responseObject is null, then return.
|
||
if (response_object == nullptr)
|
||
return;
|
||
|
||
// 4. Let response be responseObject’s response.
|
||
auto response = response_object->response();
|
||
|
||
// 5. If response’s body is non-null and is readable, then error response’s body with error.
|
||
if (response->body()) {
|
||
auto stream = response->body()->stream();
|
||
if (stream->is_readable()) {
|
||
// TODO: Implement erroring streams
|
||
(void)error;
|
||
}
|
||
}
|
||
}
|
||
|
||
}
|