ladybird/Libraries/LibWeb/Fetch/Infrastructure/Task.h

/*
 * Copyright (c) 2022, Linus Groh <linusg@serenityos.org>
 *
 * SPDX-License-Identifier: BSD-2-Clause
 */

#pragma once

#include <AK/Variant.h>
#include <LibGC/Ptr.h>
#include <LibJS/Forward.h>
#include <LibWeb/Export.h>
#include <LibWeb/Forward.h>
#include <LibWeb/HTML/EventLoop/Task.h>

namespace Web::Fetch::Infrastructure {

using TaskDestination = Variant<Empty, GC::Ref<JS::Object>, NonnullRefPtr<HTML::ParallelQueue>>;

HTML::TaskID queue_fetch_task(TaskDestination, GC::Ref<GC::Function<void()>>);
WEB_API HTML::TaskID queue_fetch_task(GC::Ref<FetchController>, TaskDestination, GC::Ref<GC::Function<void()>>);

}
LibWeb: Implement 'Queue a fetch task' AO 2022-10-25 15:36:50 -03:00			`/*`
			`* Copyright (c) 2022, Linus Groh <linusg@serenityos.org>`
			`*`
			`* SPDX-License-Identifier: BSD-2-Clause`
			`*/`

			`#pragma once`

LibWeb/Fetch: Implement Body's "fully read" function from the spec Required by XHR's reliance on Fetch. 2023-02-28 15:12:44 -03:00			`#include <AK/Variant.h>`
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root 2024-11-14 12:01:23 -03:00			`#include <LibGC/Ptr.h>`
LibWeb: Implement 'Queue a fetch task' AO 2022-10-25 15:36:50 -03:00			`#include <LibJS/Forward.h>`
LibWeb: Enable EXPLICIT_SYMBOL_EXPORT 2025-07-19 23:35:33 -03:00			`#include <LibWeb/Export.h>`
LibWeb: Track fetching-related tasks in FetchController for cancellation The HTMLMediaElement, for example, contains spec text which states any ongoing fetch process must be "stopped". The spec does not indicate how to do this, so our implementation is rather ad-hoc. Our current implementation may cause a crash in places that assume one of the fetch algorithms that we set to null is not null. For example: if (fetch_params.process_response) { queue_fetch_task([]() { fetch_params.process_response(); }; } If the fetch process is stopped after queuing the fetch task, but not before the fetch task is run, we will crash when running this fetch algorithm. We now track queued fetch tasks on the fetch controller. When the fetch process is stopped, we cancel any such pending task. It is a little bit awkward maintaining a fetch task ID. Ideally, we could use the underlying task ID throughout. But we do not have access to the underlying task nor its ID when the task is running, at which point we need some ID to remove from the pending task list. 2024-03-22 16:28:41 -03:00			`#include <LibWeb/Forward.h>`
LibWeb: Make HTML::Task IDs a sequential, distinct numeric type This also fixes a bug where task IDs were being deallocated from the wrong IDAllocator. I don't know if it was actually possible to cause any real trouble with that mistake, nor do I know how to write a test for it, but this makes the bug go away. 2024-08-04 12:10:49 -03:00			`#include <LibWeb/HTML/EventLoop/Task.h>`
LibWeb: Implement 'Queue a fetch task' AO 2022-10-25 15:36:50 -03:00
			`namespace Web::Fetch::Infrastructure {`

LibWeb: Add "parallel queue" and allow it as fetch task destination Note that it's not actually executing tasks in parallel, it's still throwing them on the HTML event loop task queue, each with its own unique task source. This makes our fetch implementation a lot more robust when HTTP caching is enabled, and you can now click links on https://terminal.shop/ without hitting TODO assertions in fetch. 2025-07-16 07:29:26 -03:00			`using TaskDestination = Variant<Empty, GC::Ref<JS::Object>, NonnullRefPtr<HTML::ParallelQueue>>;`
LibWeb/Fetch: Implement Body's "fully read" function from the spec Required by XHR's reliance on Fetch. 2023-02-28 15:12:44 -03:00
LibWeb: Add "parallel queue" and allow it as fetch task destination Note that it's not actually executing tasks in parallel, it's still throwing them on the HTML event loop task queue, each with its own unique task source. This makes our fetch implementation a lot more robust when HTTP caching is enabled, and you can now click links on https://terminal.shop/ without hitting TODO assertions in fetch. 2025-07-16 07:29:26 -03:00			`HTML::TaskID queue_fetch_task(TaskDestination, GC::Ref<GC::Function<void()>>);`
LibWeb: Enable EXPLICIT_SYMBOL_EXPORT 2025-07-19 23:35:33 -03:00			`WEB_API HTML::TaskID queue_fetch_task(GC::Ref<FetchController>, TaskDestination, GC::Ref<GC::Function<void()>>);`
LibWeb: Implement 'Queue a fetch task' AO 2022-10-25 15:36:50 -03:00
			`}`