mirror of
				https://github.com/LadybirdBrowser/ladybird.git
				synced 2025-11-04 07:10:57 +00:00 
			
		
		
		
	And return that ID when queueing an element task. This is required for some task tracking - specifically, the HTML ToggleTaskTracker struct.
		
			
				
	
	
		
			86 lines
		
	
	
	
		
			2.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
			
		
		
	
	
			86 lines
		
	
	
	
		
			2.2 KiB
		
	
	
	
		
			C++
		
	
	
	
	
	
/*
 | 
						|
 * Copyright (c) 2021-2022, Andreas Kling <kling@serenityos.org>
 | 
						|
 *
 | 
						|
 * SPDX-License-Identifier: BSD-2-Clause
 | 
						|
 */
 | 
						|
 | 
						|
#pragma once
 | 
						|
 | 
						|
#include <AK/Function.h>
 | 
						|
#include <AK/NonnullOwnPtr.h>
 | 
						|
#include <AK/RefPtr.h>
 | 
						|
#include <LibJS/Heap/Handle.h>
 | 
						|
#include <LibJS/SafeFunction.h>
 | 
						|
#include <LibWeb/Forward.h>
 | 
						|
 | 
						|
namespace Web::HTML {
 | 
						|
 | 
						|
struct UniqueTaskSource;
 | 
						|
 | 
						|
class Task {
 | 
						|
public:
 | 
						|
    // https://html.spec.whatwg.org/multipage/webappapis.html#generic-task-sources
 | 
						|
    enum class Source {
 | 
						|
        Unspecified,
 | 
						|
        DOMManipulation,
 | 
						|
        UserInteraction,
 | 
						|
        Networking,
 | 
						|
        HistoryTraversal,
 | 
						|
        IdleTask,
 | 
						|
        PostedMessage,
 | 
						|
        Microtask,
 | 
						|
        TimerTask,
 | 
						|
        JavaScriptEngine,
 | 
						|
 | 
						|
        // https://html.spec.whatwg.org/multipage/webappapis.html#navigation-and-traversal-task-source
 | 
						|
        NavigationAndTraversal,
 | 
						|
 | 
						|
        // https://w3c.github.io/FileAPI/#fileReadingTaskSource
 | 
						|
        FileReading,
 | 
						|
 | 
						|
        // https://www.w3.org/TR/intersection-observer/#intersectionobserver-task-source
 | 
						|
        IntersectionObserver,
 | 
						|
 | 
						|
        // https://w3c.github.io/performance-timeline/#dfn-performance-timeline-task-source
 | 
						|
        PerformanceTimeline,
 | 
						|
 | 
						|
        // https://html.spec.whatwg.org/multipage/canvas.html#canvas-blob-serialisation-task-source
 | 
						|
        CanvasBlobSerializationTask,
 | 
						|
 | 
						|
        // !!! IMPORTANT: Keep this field last!
 | 
						|
        // This serves as the base value of all unique task sources.
 | 
						|
        // Some elements, such as the HTMLMediaElement, must have a unique task source per instance.
 | 
						|
        UniqueTaskSourceStart
 | 
						|
    };
 | 
						|
 | 
						|
    static NonnullOwnPtr<Task> create(Source source, DOM::Document const* document, JS::SafeFunction<void()> steps)
 | 
						|
    {
 | 
						|
        return adopt_own(*new Task(source, document, move(steps)));
 | 
						|
    }
 | 
						|
    ~Task();
 | 
						|
 | 
						|
    int id() const { return m_id; }
 | 
						|
    Source source() const { return m_source; }
 | 
						|
    void execute();
 | 
						|
 | 
						|
    DOM::Document const* document() const;
 | 
						|
 | 
						|
    bool is_runnable() const;
 | 
						|
 | 
						|
private:
 | 
						|
    Task(Source, DOM::Document const*, JS::SafeFunction<void()> steps);
 | 
						|
 | 
						|
    int m_id { 0 };
 | 
						|
    Source m_source { Source::Unspecified };
 | 
						|
    JS::SafeFunction<void()> m_steps;
 | 
						|
    JS::Handle<DOM::Document const> m_document;
 | 
						|
};
 | 
						|
 | 
						|
struct UniqueTaskSource {
 | 
						|
    UniqueTaskSource();
 | 
						|
    ~UniqueTaskSource();
 | 
						|
 | 
						|
    Task::Source const source;
 | 
						|
};
 | 
						|
 | 
						|
}
 |