/* * Copyright (c) 2018-2020, Andreas Kling * * SPDX-License-Identifier: BSD-2-Clause */ #pragma once #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web::DOM { enum class QuirksMode { No, Limited, Yes }; class Document : public ParentNode , public NonElementParentNode , public HTML::GlobalEventHandlers , public Bindings::ScriptExecutionContext { public: using WrapperType = Bindings::DocumentWrapper; static NonnullRefPtr create(const URL& url = "about:blank") { return adopt_ref(*new Document(url)); } static NonnullRefPtr create_with_global_object(Bindings::WindowObject&) { return Document::create(); } virtual ~Document() override; String cookie(Cookie::Source = Cookie::Source::NonHttp); void set_cookie(String, Cookie::Source = Cookie::Source::NonHttp); bool should_invalidate_styles_on_attribute_changes() const { return m_should_invalidate_styles_on_attribute_changes; } void set_should_invalidate_styles_on_attribute_changes(bool b) { m_should_invalidate_styles_on_attribute_changes = b; } void set_url(const URL& url) { m_url = url; } URL url() const { return m_url; } Origin origin() const; void set_origin(const Origin& origin); bool is_scripting_enabled() const { return true; } URL complete_url(const String&) const; CSS::StyleResolver& style_resolver() { return *m_style_resolver; } const CSS::StyleResolver& style_resolver() const { return *m_style_resolver; } CSS::StyleSheetList& style_sheets() { return *m_style_sheets; } const CSS::StyleSheetList& style_sheets() const { return *m_style_sheets; } NonnullRefPtr style_sheets_for_bindings() { return *m_style_sheets; } virtual FlyString node_name() const override { return "#document"; } void set_hovered_node(Node*); Node* hovered_node() { return m_hovered_node; } const Node* hovered_node() const { return m_hovered_node; } void set_inspected_node(Node*); Node* inspected_node() { return m_inspected_node; } const Node* inspected_node() const { return m_inspected_node; } Element* document_element(); const Element* document_element() const; HTML::HTMLHtmlElement* html_element(); HTML::HTMLHeadElement* head(); HTML::HTMLElement* body(); const HTML::HTMLHtmlElement* html_element() const { return const_cast(this)->html_element(); } const HTML::HTMLHeadElement* head() const { return const_cast(this)->head(); } const HTML::HTMLElement* body() const { return const_cast(this)->body(); } ExceptionOr set_body(HTML::HTMLElement* new_body); String title() const; void set_title(const String&); void attach_to_browsing_context(Badge, BrowsingContext&); void detach_from_browsing_context(Badge, BrowsingContext&); BrowsingContext* browsing_context() { return m_browsing_context.ptr(); } const BrowsingContext* browsing_context() const { return m_browsing_context.ptr(); } Page* page(); const Page* page() const; Color background_color(const Gfx::Palette&) const; RefPtr background_image() const; CSS::Repeat background_repeat_x() const; CSS::Repeat background_repeat_y() const; Color link_color() const; void set_link_color(Color); Color active_link_color() const; void set_active_link_color(Color); Color visited_link_color() const; void set_visited_link_color(Color); void force_layout(); void invalidate_layout(); void update_style(); void update_layout(); virtual bool is_child_allowed(const Node&) const override; const Layout::InitialContainingBlockBox* layout_node() const; Layout::InitialContainingBlockBox* layout_node(); void schedule_style_update(); void schedule_forced_layout(); NonnullRefPtr get_elements_by_name(String const&); NonnullRefPtr get_elements_by_tag_name(FlyString const&); NonnullRefPtr get_elements_by_class_name(FlyString const&); NonnullRefPtr applets(); NonnullRefPtr anchors(); NonnullRefPtr images(); NonnullRefPtr embeds(); NonnullRefPtr plugins(); NonnullRefPtr links(); NonnullRefPtr forms(); NonnullRefPtr scripts(); const String& source() const { return m_source; } void set_source(const String& source) { m_source = source; } virtual JS::Interpreter& interpreter() override; JS::Value run_javascript(const StringView& source, const StringView& filename = "(unknown)"); NonnullRefPtr create_element(const String& tag_name); NonnullRefPtr create_element_ns(const String& namespace_, const String& qualifed_name); NonnullRefPtr create_document_fragment(); NonnullRefPtr create_text_node(const String& data); NonnullRefPtr create_comment(const String& data); NonnullRefPtr create_range(); NonnullRefPtr create_event(const String& interface); void set_pending_parsing_blocking_script(Badge, HTML::HTMLScriptElement*); HTML::HTMLScriptElement* pending_parsing_blocking_script() { return m_pending_parsing_blocking_script; } NonnullRefPtr take_pending_parsing_blocking_script(Badge); void add_script_to_execute_when_parsing_has_finished(Badge, HTML::HTMLScriptElement&); NonnullRefPtrVector take_scripts_to_execute_when_parsing_has_finished(Badge); void add_script_to_execute_as_soon_as_possible(Badge, HTML::HTMLScriptElement&); NonnullRefPtrVector take_scripts_to_execute_as_soon_as_possible(Badge); QuirksMode mode() const { return m_quirks_mode; } bool in_quirks_mode() const { return m_quirks_mode == QuirksMode::Yes; } void set_quirks_mode(QuirksMode mode) { m_quirks_mode = mode; } void adopt_node(Node&); ExceptionOr> adopt_node_binding(NonnullRefPtr); const DocumentType* doctype() const; const String& compat_mode() const; void set_editable(bool editable) { m_editable = editable; } virtual bool is_editable() const final; Element* focused_element() { return m_focused_element; } const Element* focused_element() const { return m_focused_element; } void set_focused_element(Element*); const Element* active_element() const { return m_active_element; } void set_active_element(Element*); bool created_for_appropriate_template_contents() const { return m_created_for_appropriate_template_contents; } void set_created_for_appropriate_template_contents(bool value) { m_created_for_appropriate_template_contents = value; } Document* associated_inert_template_document() { return m_associated_inert_template_document; } const Document* associated_inert_template_document() const { return m_associated_inert_template_document; } void set_associated_inert_template_document(Document& document) { m_associated_inert_template_document = document; } const String& ready_state() const { return m_ready_state; } void set_ready_state(const String&); void ref_from_node(Badge) { increment_referencing_node_count(); } void unref_from_node(Badge) { decrement_referencing_node_count(); } void removed_last_ref(); Window& window() { return *m_window; } Window* default_view() { return m_window; } const String& content_type() const { return m_content_type; } void set_content_type(const String& content_type) { m_content_type = content_type; } bool has_encoding() const { return m_encoding.has_value(); } const Optional& encoding() const { return m_encoding; } String encoding_or_default() const { return m_encoding.value_or("UTF-8"); } void set_encoding(const Optional& encoding) { m_encoding = encoding; } // NOTE: These are intended for the JS bindings String character_set() const { return encoding_or_default(); } String charset() const { return encoding_or_default(); } String input_encoding() const { return encoding_or_default(); } bool ready_for_post_load_tasks() const { return m_ready_for_post_load_tasks; } void set_ready_for_post_load_tasks(bool ready) { m_ready_for_post_load_tasks = ready; } void completely_finish_loading(); const NonnullRefPtr implementation() const { return m_implementation; } RefPtr current_script() const { return m_current_script; } void set_current_script(Badge, RefPtr script) { m_current_script = script; } u32 ignore_destructive_writes_counter() const { return m_ignore_destructive_writes_counter; } void increment_ignore_destructive_writes_counter() { m_ignore_destructive_writes_counter++; } void decrement_ignore_destructive_writes_counter() { m_ignore_destructive_writes_counter--; } virtual EventTarget* get_parent(const Event&) override; String dump_dom_tree_as_json() const; private: explicit Document(const URL&); // ^DOM::Node virtual RefPtr create_layout_node() override; // ^HTML::GlobalEventHandlers virtual EventTarget& global_event_handlers_to_event_target() final { return *this; } void tear_down_layout_tree(); void increment_referencing_node_count() { VERIFY(!m_deletion_has_begun); ++m_referencing_node_count; } void decrement_referencing_node_count() { VERIFY(!m_deletion_has_begun); VERIFY(m_referencing_node_count); --m_referencing_node_count; if (!m_referencing_node_count && !ref_count()) { m_deletion_has_begun = true; delete this; } } unsigned m_referencing_node_count { 0 }; OwnPtr m_style_resolver; RefPtr m_style_sheets; RefPtr m_hovered_node; RefPtr m_inspected_node; WeakPtr m_browsing_context; URL m_url; RefPtr m_window; RefPtr m_layout_root; Optional m_link_color; Optional m_active_link_color; Optional m_visited_link_color; RefPtr m_style_update_timer; RefPtr m_forced_layout_timer; String m_source; OwnPtr m_interpreter; RefPtr m_pending_parsing_blocking_script; NonnullRefPtrVector m_scripts_to_execute_when_parsing_has_finished; NonnullRefPtrVector m_scripts_to_execute_as_soon_as_possible; QuirksMode m_quirks_mode { QuirksMode::No }; bool m_editable { false }; WeakPtr m_focused_element; WeakPtr m_active_element; bool m_created_for_appropriate_template_contents { false }; RefPtr m_associated_inert_template_document; String m_ready_state { "loading" }; String m_content_type { "application/xml" }; Optional m_encoding; bool m_ready_for_post_load_tasks { false }; NonnullRefPtr m_implementation; RefPtr m_current_script; bool m_should_invalidate_styles_on_attribute_changes { true }; u32 m_ignore_destructive_writes_counter { 0 }; }; }