/* * Copyright (c) 2022, Andreas Kling * Copyright (c) 2025, Jelle Raaijmakers * Copyright (c) 2023-2025, Aliaksandr Kalenik * * SPDX-License-Identifier: BSD-2-Clause */ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include namespace Web::HTML { GC_DEFINE_ALLOCATOR(TraversableNavigable); TraversableNavigable::TraversableNavigable(GC::Ref page) : Navigable( page, page->client().is_svg_page_client(), Compositor::PagePresentationRegistration::Yes) , m_storage_shed(StorageAPI::StorageShed::create(page->heap())) , m_session_history_traversal_queue(vm().heap().allocate()) { } TraversableNavigable::~TraversableNavigable() = default; void TraversableNavigable::visit_edges(Cell::Visitor& visitor) { Base::visit_edges(visitor); if (m_emulated_position_data.has>()) visitor.visit(m_emulated_position_data.get>()); visitor.visit(m_session_history_traversal_queue); visitor.visit(m_storage_shed); visitor.visit(m_apply_history_step_state); visitor.visit(m_paused_apply_history_step_state); } static OrderedHashTable& user_agent_top_level_traversable_set() { static NeverDestroyed> set; return *set; } // https://html.spec.whatwg.org/multipage/document-sequences.html#creating-a-new-top-level-browsing-context BrowsingContextAndDocument create_a_new_top_level_browsing_context_and_document(GC::Ref page) { // 1. Let group and document be the result of creating a new browsing context group and document. auto [group, document] = BrowsingContextGroup::create_a_new_browsing_context_group_and_document(page); // 2. Return group's browsing context set[0] and document. return BrowsingContextAndDocument { **group->browsing_context_set().begin(), document }; } // https://html.spec.whatwg.org/multipage/document-sequences.html#creating-a-new-top-level-traversable GC::Ref TraversableNavigable::create_a_new_top_level_traversable(GC::Ref page, GC::Ptr opener, String target_name) { auto& vm = Bindings::main_thread_vm(); page->ensure_compositor_host(); // 1. Let document be null. GC::Ptr document = nullptr; // 2. If opener is null, then set document to the second return value of creating a new top-level browsing context and document. if (!opener) { document = create_a_new_top_level_browsing_context_and_document(page).document; } // 3. Otherwise, set document to the second return value of creating a new auxiliary browsing context and document given opener. else { document = BrowsingContext::create_a_new_auxiliary_browsing_context_and_document(page, *opener).document; } // 4. Let documentState be a new document state, with auto document_state = DocumentState::create(); // document: document (now owned by Navigable::m_active_document, not DocumentState) // initiator origin: null if opener is null; otherwise, document's origin document_state->set_initiator_origin(opener ? document->origin() : Optional {}); // origin: document's origin document_state->set_origin(document->origin()); // navigable target name: targetName document_state->set_navigable_target_name(target_name); // about base URL: document's about base URL document_state->set_about_base_url(document->about_base_url()); // 5. Let traversable be a new traversable navigable. auto traversable = vm.heap().allocate(page); // 6. Initialize the navigable traversable given documentState. traversable->initialize_navigable(document_state, nullptr, *document); // 7. Let initialHistoryEntry be traversable's active session history entry. auto initial_history_entry = traversable->active_session_history_entry(); VERIFY(initial_history_entry); // 8. Set initialHistoryEntry's step to 0. initial_history_entry->set_step(0); // 9. Append initialHistoryEntry to traversable's session history entries. traversable->m_session_history_entries.append(*initial_history_entry); traversable->set_has_session_history_entry_and_ready_for_navigation(); // 10. If opener is non-null, then legacy-clone a traversable storage shed given opener's top-level traversable and traversable. [STORAGE] if (opener) { auto opener_traversable = opener->top_level_traversable(); traversable->storage_shed().legacy_clone(opener_traversable->storage_shed(), page); } // 11. Append traversable to the user agent's top-level traversable set. user_agent_top_level_traversable_set().set(traversable); // 12. Return traversable. return traversable; } // https://html.spec.whatwg.org/multipage/document-sequences.html#create-a-fresh-top-level-traversable GC::Ref TraversableNavigable::create_a_fresh_top_level_traversable(GC::Ref page, URL::URL const& initial_navigation_url, Variant initial_navigation_post_resource) { // 1. Let traversable be the result of creating a new top-level traversable given null and the empty string. auto traversable = create_a_new_top_level_traversable(page, nullptr, {}); page->set_top_level_traversable(traversable); // AD-HOC: Set the default top-level emulated position data for the traversable, which points to Market St. SF. // FIXME: We should not emulate by default, but ask the user what to do. E.g. disable Geolocation, set an emulated // position, or allow Ladybird to engage with the system's geolocation services. This is completely separate // from the permission model for "powerful features" such as Geolocation. auto& realm = traversable->active_document()->realm(); auto emulated_position_coordinates = realm.create( realm, Geolocation::CoordinatesData { .accuracy = 100.0, .latitude = 37.7647658, .longitude = -122.4345892, .altitude = 60.0, .altitude_accuracy = 10.0, .heading = 0.0, .speed = 0.0, }); traversable->set_emulated_position_data(emulated_position_coordinates); // AD-HOC: Mark the about:blank document as finished parsing if we're only going to about:blank // Skip the initial navigation as well. This matches the behavior of the window open steps. if (url_matches_about_blank(initial_navigation_url)) { Platform::EventLoopPlugin::the().deferred_invoke(GC::create_function(traversable->heap(), [traversable, initial_navigation_url] { // FIXME: We do this other places too when creating a new about:blank document. Perhaps it's worth a spec issue? HTML::HTMLParser::the_end(*traversable->active_document()); // FIXME: If we perform the URL and history update steps here, we start hanging tests and the UI process will // try to load() the initial URLs passed on the command line before we finish processing the events here. // However, because we call this before the PageClient is fully initialized... that gets awkward. })); } else { // 2. Navigate traversable to initialNavigationURL using traversable's active document, with documentResource set to initialNavigationPostResource. MUST(traversable->navigate({ .url = initial_navigation_url, .source_document = *traversable->active_document(), .document_resource = initial_navigation_post_resource })); } // 3. Return traversable. return traversable; } // https://html.spec.whatwg.org/multipage/document-sequences.html#top-level-traversable bool TraversableNavigable::is_top_level_traversable() const { // A top-level traversable is a traversable navigable with a null parent. return parent() == nullptr; } static bool session_history_entry_descriptors_are_valid(Vector const& entries) { Optional previous_step; for (auto const& entry : entries) { if (entry.step < 0) return false; if (previous_step.has_value() && entry.step <= *previous_step) return false; for (auto const& nested_history : entry.document_state.nested_histories) { if (!session_history_entry_descriptors_are_valid(nested_history.entries)) return false; } previous_step = entry.step; } return true; } struct SessionHistoryEntryReconstructionState { HashMap> document_states; }; static NonnullRefPtr create_session_history_entry_from_ui_process(SessionHistoryEntryDescriptor, SessionHistoryEntryReconstructionState&); static DocumentState::NestedHistory create_nested_history_from_ui_process(SessionHistoryNestedHistoryDescriptor nested_history_descriptor, SessionHistoryEntryReconstructionState& reconstruction_state) { Vector> entries; entries.ensure_capacity(nested_history_descriptor.entries.size()); for (auto& entry_descriptor : nested_history_descriptor.entries) entries.unchecked_append(create_session_history_entry_from_ui_process(move(entry_descriptor), reconstruction_state)); return { .id = move(nested_history_descriptor.id), .entries = move(entries), }; } static void populate_nested_histories_from_ui_process(DocumentState& document_state, Vector nested_history_descriptors, SessionHistoryEntryReconstructionState& reconstruction_state) { auto& nested_histories = document_state.nested_histories(); if (nested_histories.size() == nested_history_descriptors.size()) { // NB: The UI process keeps session history across WebContent process // swaps, but nested history ids are process-local navigable ids. When // rebuilding history for an already-loaded document, preserve the live // ids created by the new WebContent process. for (size_t i = 0; i < nested_history_descriptors.size(); ++i) nested_history_descriptors[i].id = nested_histories[i].id; } nested_histories.clear(); nested_histories.ensure_capacity(nested_history_descriptors.size()); for (auto& nested_history_descriptor : nested_history_descriptors) nested_histories.unchecked_append(create_nested_history_from_ui_process(move(nested_history_descriptor), reconstruction_state)); } static void apply_session_history_entry_descriptor_from_ui_process(SessionHistoryEntry& entry, SessionHistoryEntryDescriptor& entry_descriptor) { entry.set_url(move(entry_descriptor.url)); entry.set_step(static_cast(entry_descriptor.step)); // NB: Older UI-process mirrors can carry an empty serialization record for // provisional entries. Do not preserve stale state from a reused entry, but // also do not install an invalid record that would crash when restored. auto& vm = Bindings::main_thread_vm(); if (entry_descriptor.classic_history_api_state.is_empty()) entry.set_classic_history_api_state(MUST(structured_serialize_for_storage(vm, JS::js_null()))); else entry.set_classic_history_api_state(move(entry_descriptor.classic_history_api_state)); if (entry_descriptor.navigation_api_state.is_empty()) entry.set_navigation_api_state(MUST(structured_serialize_for_storage(vm, JS::js_undefined()))); else entry.set_navigation_api_state(move(entry_descriptor.navigation_api_state)); entry.set_navigation_api_key(move(entry_descriptor.navigation_api_key)); entry.set_navigation_api_id(move(entry_descriptor.navigation_api_id)); entry.set_scroll_restoration_mode(entry_descriptor.scroll_restoration_mode); entry.set_scroll_position_data(move(entry_descriptor.scroll_position_data)); } static void apply_session_history_document_state_descriptor_from_ui_process(DocumentState& document_state, SessionHistoryDocumentStateDescriptor const& document_state_descriptor) { document_state.set_history_policy_container(document_state_descriptor.history_policy_container); document_state.set_request_referrer(document_state_descriptor.request_referrer); document_state.set_request_referrer_policy(document_state_descriptor.request_referrer_policy); document_state.set_initiator_origin(document_state_descriptor.initiator_origin); document_state.set_origin(document_state_descriptor.origin); document_state.set_about_base_url(document_state_descriptor.about_base_url); document_state.set_resource(document_state_descriptor.resource); document_state.set_reload_pending(document_state_descriptor.reload_pending); // AD-HOC: Descriptor ID 0 marks a provisional UI-created document state whose entry has not yet been populated // by WebContent. Treat it as already populated when reseeding the active entry, since a replacement // WebContent process already has the active document for that entry. document_state.set_ever_populated(document_state_descriptor.id == 0 ? true : document_state_descriptor.ever_populated); document_state.set_navigable_target_name(document_state_descriptor.navigable_target_name); } static RefPtr get_or_create_document_state_from_ui_process(SessionHistoryDocumentStateDescriptor const& document_state_descriptor, SessionHistoryEntryReconstructionState& reconstruction_state) { RefPtr document_state; if (document_state_descriptor.id != 0) { if (auto existing_document_state = reconstruction_state.document_states.get(document_state_descriptor.id); existing_document_state.has_value()) document_state = *existing_document_state; } if (!document_state) { document_state = DocumentState::create(); if (document_state_descriptor.id != 0) reconstruction_state.document_states.set(document_state_descriptor.id, document_state); } apply_session_history_document_state_descriptor_from_ui_process(*document_state, document_state_descriptor); return document_state; } static NonnullRefPtr create_session_history_entry_from_ui_process(SessionHistoryEntryDescriptor entry_descriptor, SessionHistoryEntryReconstructionState& reconstruction_state) { auto entry = SessionHistoryEntry::create(); apply_session_history_entry_descriptor_from_ui_process(*entry, entry_descriptor); auto document_state = get_or_create_document_state_from_ui_process(entry_descriptor.document_state, reconstruction_state); VERIFY(document_state); populate_nested_histories_from_ui_process(*document_state, move(entry_descriptor.document_state.nested_histories), reconstruction_state); entry->set_document_state(move(document_state)); return entry; } static bool synchronous_same_document_navigation_must_preserve_ongoing_navigation(Navigable const& navigable) { // AD-HOC: The spec queues same-document history updates because they happen synchronously, outside the traversal // queue, and must later resolve races with the current history step. If another navigation has already // claimed the navigable, leave that navigation ID alone. This matches Chromium, WebKit, and Gecko: // a same-document history update from the same task does not cancel a later cross-document navigation. return navigable.ongoing_navigation().has(); } static bool expected_ongoing_navigation_was_superseded(GC::Ptr navigable, Optional const& expected_navigation_id) { if (!navigable || !expected_navigation_id.has_value()) return false; if (navigable->has_been_destroyed()) return true; return navigable->ongoing_navigation() != *expected_navigation_id; } bool TraversableNavigable::replace_top_level_session_history_entries_from_ui_process(Vector entries_from_ui_process, size_t current_top_level_entry_index, bool allow_reconstructing_current_entry) { if (entries_from_ui_process.is_empty() || current_top_level_entry_index >= entries_from_ui_process.size()) return false; VERIFY(is_top_level_traversable()); if (!session_history_entry_descriptors_are_valid(entries_from_ui_process)) return false; // NB: The UI process stores a traversable's top-level session history entries // across WebContent process swaps. When seeding a fresh WebContent process, // current_top_level_entry_index is an index into the traversable's session // history entries list, not an index into the result of getting all used // history steps. // https://html.spec.whatwg.org/multipage/document-sequences.html#tn-session-history-entries // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-all-used-history-steps auto active_entry = active_session_history_entry(); VERIFY(active_entry); auto active_document = this->active_document(); VERIFY(active_document); if (!active_document->is_initial_about_blank()) { // NB: The UI process can ask WebContent to reseed its top-level session history after observing an // incomplete or stale snapshot. Same-document history updates are committed synchronously in WebContent, // while the UI-process mirror is necessarily fed by async IPC. If that mirror sends back an older current // entry, accepting it would clobber the active document's live latest entry and make a queued traversal // target unreachable. Rejecting the seed lets the UI process converge from WebContent's current snapshot // instead. Descriptor ID 0 means the UI process only has a provisional document state; do not apply that // to a live non-initial document. Process-swap/preload seeds still go through the initial about:blank path // above. auto const& current_entry_from_ui_process = entries_from_ui_process[current_top_level_entry_index]; if (current_entry_from_ui_process.document_state.id == 0) return false; // NB: Nested histories can be UI-owned state that is intentionally restored after the current top-level // document has loaded. The live latest entry must still match the UI seed's top-level state, but requiring // nested histories to match would reject the state we are being asked to restore. auto latest_entry = active_document->latest_entry(); if (!latest_entry) return false; auto latest_entry_matches_ui_seed = session_history_entry_matches_descriptor_ignoring_document_state_id(*latest_entry, current_entry_from_ui_process, MatchNestedHistories::No); auto active_entry_is_latest_entry = latest_entry.ptr() == active_entry.ptr(); auto current_entry_url_matches_ui_seed = latest_entry->url() == current_entry_from_ui_process.url; // NB: A UI-process fallback load starts a fresh WebContent process with a single top-level entry for the URL // being restored, then seeds the UI-owned traversable session history around that document. The fresh // entry has local step and Navigation API identity, so accept the seed when the process has no other // top-level history to protect. auto can_restore_fresh_ui_history_load = entries_from_ui_process.size() > 1 && m_session_history_entries.size() == 1 && active_entry.ptr() == m_session_history_entries.first().ptr() && active_entry_is_latest_entry && current_entry_url_matches_ui_seed; // NB: Crash recovery pre-seeds WebContent before loading the current entry, then reseeds after the document is // loaded so same-document state, Navigation API state, scroll restoration mode, and target name are // restored onto the fresh Document. At that point WebContent already has the UI-owned top-level history and // step coordinates, but the active entry can still have freshly loaded document state. auto latest_entry_step = latest_entry->step_value(); auto can_restore_preseeded_ui_history_load = latest_entry_step.has_value() && *latest_entry_step == current_entry_from_ui_process.step && m_session_history_entries.size() == entries_from_ui_process.size() && active_entry_is_latest_entry && current_entry_url_matches_ui_seed; // NB: UI-process fallback history loads can overlap when a newer traversal supersedes an older one before the // older load has finished. Other engines give pending history loads an identity so the latest traversal // stays authoritative; after the race has happened, WebContent can still have the latest live document in // an incomplete local top-level list, for example [b, c] while the UI process is restoring [a, b, c] at c. // If the live active entry has the UI seed's current URL, accept the UI-owned list around that document // instead of making the UI process adopt the incomplete WebContent list. The WebContent step, document state // id, and Navigation API identity are all process-local placeholders at this point, and are replaced by the // UI-owned values below. auto can_restore_current_entry_after_superseded_ui_history_load = entries_from_ui_process.size() > m_session_history_entries.size() && active_entry_is_latest_entry && current_entry_url_matches_ui_seed; auto can_reconstruct_current_entry = allow_reconstructing_current_entry && (can_restore_fresh_ui_history_load || can_restore_preseeded_ui_history_load || can_restore_current_entry_after_superseded_ui_history_load); if (!latest_entry_matches_ui_seed && !can_reconstruct_current_entry) return false; } SessionHistoryEntryReconstructionState reconstruction_state; if (entries_from_ui_process[current_top_level_entry_index].document_state.id != 0) { auto active_document_state = active_entry->document_state(); VERIFY(active_document_state); reconstruction_state.document_states.set(entries_from_ui_process[current_top_level_entry_index].document_state.id, active_document_state); } Vector> entries; entries.ensure_capacity(entries_from_ui_process.size()); for (size_t i = 0; i < entries_from_ui_process.size(); ++i) { auto entry_descriptor = move(entries_from_ui_process[i]); NonnullRefPtr entry = *active_entry; if (i == current_top_level_entry_index) { VERIFY(entry->document_state()); apply_session_history_entry_descriptor_from_ui_process(*entry, entry_descriptor); apply_session_history_document_state_descriptor_from_ui_process(*entry->document_state(), entry_descriptor.document_state); populate_nested_histories_from_ui_process(*entry->document_state(), move(entry_descriptor.document_state.nested_histories), reconstruction_state); } else { entry = create_session_history_entry_from_ui_process(move(entry_descriptor), reconstruction_state); } entries.unchecked_append(move(entry)); } m_session_history_entries = move(entries); auto current_entry = m_session_history_entries[current_top_level_entry_index]; set_active_session_history_entry(current_entry); set_current_session_history_entry(current_entry); m_current_session_history_step = current_entry->step().get(); auto document = this->active_document(); VERIFY(document); auto history_object_length_and_index = get_the_history_object_length_and_index(m_current_session_history_step); document->history()->m_index = history_object_length_and_index.script_history_index; document->history()->m_length = history_object_length_and_index.script_history_length; // NB: The UI process can seed a replacement WebContent process before the new document has loaded. Do not // restore the UI-owned entry's classic history API state or persisted state onto the initial about:blank // document; the navigation algorithm will restore them onto the document that is actually created for the // entry. if (!document->is_initial_about_blank()) { document->restore_the_history_object_state(current_entry); restore_persisted_state_from_session_history_entry(*current_entry); } auto entries_for_navigation_api = get_session_history_entries_for_the_navigation_api(*this, m_current_session_history_step); active_window()->navigation()->initialize_the_navigation_api_entries_for_reconstructed_session_history(entries_for_navigation_api, current_entry); return true; } void TraversableNavigable::reset_session_history_for_testing(GC::Ref> on_complete) { append_session_history_traversal_steps(GC::create_function(heap(), [this, on_complete](NonnullRefPtr> signal) { auto maybe_active_entry = active_session_history_entry(); VERIFY(maybe_active_entry); auto active_entry = maybe_active_entry.release_nonnull(); active_entry->set_step(0); m_session_history_entries.clear(); m_session_history_entries.append(active_entry); set_active_session_history_entry(active_entry); set_current_session_history_entry(active_entry); m_current_session_history_step = 0; auto document = active_document(); VERIFY(document); auto history_object_length_and_index = get_the_history_object_length_and_index(m_current_session_history_step); document->history()->m_index = history_object_length_and_index.script_history_index; document->history()->m_length = history_object_length_and_index.script_history_length; auto entries_for_navigation_api = get_session_history_entries_for_the_navigation_api(*this, m_current_session_history_step); active_window()->navigation()->initialize_the_navigation_api_entries_for_reconstructed_session_history(entries_for_navigation_api, active_entry); if (page().client().should_report_session_history_updates()) { auto session_history_snapshot = create_session_history_snapshot(); page().client().page_did_update_session_history(session_history_snapshot.top_level_session_history_entries, session_history_snapshot.used_session_history_steps, session_history_snapshot.current_used_step_index); } page().client().page_did_update_navigation_buttons_state(false, false); signal->resolve({}); on_complete->function()(); })); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-all-used-history-steps Vector TraversableNavigable::get_all_used_history_steps() const { // FIXME: 1. Assert: this is running within traversable's session history traversal queue. // 2. Let steps be an empty ordered set of non-negative integers. OrderedHashTable steps; // 3. Let entryLists be the ordered set « traversable's session history entries ». Vector>> entry_lists { session_history_entries() }; // 4. For each entryList of entryLists: while (!entry_lists.is_empty()) { auto entry_list = entry_lists.take_first(); // 1. For each entry of entryList: for (auto& entry : entry_list) { // 1. Append entry's step to steps. // NB: "pending" is not a used history step. // https://html.spec.whatwg.org/multipage/browsing-the-web.html#she-step if (auto entry_step = entry->step_value(); entry_step.has_value()) { steps.set(*entry_step); } else { continue; } // 2. For each nestedHistory of entry's document state's nested histories, append nestedHistory's entries list to entryLists. for (auto& nested_history : entry->document_state()->nested_histories()) entry_lists.append(nested_history.entries); } } // 5. Return steps, sorted. auto sorted_steps = steps.values(); quick_sort(sorted_steps); return sorted_steps; } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-the-history-object-length-and-index TraversableNavigable::HistoryObjectLengthAndIndex TraversableNavigable::get_the_history_object_length_and_index(int step) const { // 1. Let steps be the result of getting all used history steps within traversable. auto steps = get_all_used_history_steps(); // 2. Let scriptHistoryLength be the size of steps. auto script_history_length = steps.size(); // 3. Assert: steps contains step. VERIFY(steps.contains_slow(step)); // 4. Let scriptHistoryIndex be the index of step in steps. auto script_history_index = *steps.find_first_index(step); // 5. Return (scriptHistoryLength, scriptHistoryIndex). return HistoryObjectLengthAndIndex { .script_history_length = script_history_length, .script_history_index = script_history_index }; } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-the-used-step int TraversableNavigable::get_the_used_step(int step) const { // 1. Let steps be the result of getting all used history steps within traversable. auto steps = get_all_used_history_steps(); // 2. Return the greatest item in steps that is less than or equal to step. VERIFY(!steps.is_empty()); Optional result; for (size_t i = 0; i < steps.size(); i++) { if (steps[i] <= step) { if (!result.has_value() || (result.value() < steps[i])) { result = steps[i]; } } } return result.value(); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#get-all-navigables-whose-current-session-history-entry-will-change-or-reload Vector> TraversableNavigable::get_all_navigables_whose_current_session_history_entry_will_change_or_reload(int target_step) const { // 1. Let results be an empty list. Vector> results; // 2. Let navigablesToCheck be « traversable ». Vector> navigables_to_check; navigables_to_check.append(const_cast(*this)); // 3. For each navigable of navigablesToCheck: while (!navigables_to_check.is_empty()) { auto navigable = navigables_to_check.take_first(); // 1. Let targetEntry be the result of getting the target history entry given navigable and targetStep. auto target_entry = navigable->get_the_target_history_entry_if_present(target_step); if (!target_entry) continue; // 2. If targetEntry is not navigable's current session history entry or targetEntry's document state's reload // pending is true, then append navigable to results. // AD-HOC: We don't want to choose a navigable that has ongoing traversal. if ((target_entry != navigable->current_session_history_entry() || target_entry->document_state()->reload_pending()) && !navigable->ongoing_navigation().has()) { results.append(*navigable); } // 3. If targetEntry's document is navigable's document, and targetEntry's document state's reload pending is // false, then extend navigablesToCheck with the child navigables of navigable. if (target_entry->document_state()->document_id() == navigable->active_document_id() && !target_entry->document_state()->reload_pending()) { navigables_to_check.extend(navigable->child_navigables()); } } // 4. Return results. return results; } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-all-navigables-that-only-need-history-object-length/index-update Vector> TraversableNavigable::get_all_navigables_that_only_need_history_object_length_index_update(int target_step) const { // NOTE: Other navigables might not be impacted by the traversal. For example, if the response is a 204, the currently active document will remain. // Additionally, going 'back' after a 204 will change the current session history entry, but the active session history entry will already be correct. // 1. Let results be an empty list. Vector> results; // 2. Let navigablesToCheck be « traversable ». Vector> navigables_to_check; navigables_to_check.append(const_cast(*this)); // 3. For each navigable of navigablesToCheck: while (!navigables_to_check.is_empty()) { auto navigable = navigables_to_check.take_first(); // 1. Let targetEntry be the result of getting the target history entry given navigable and targetStep. auto target_entry = navigable->get_the_target_history_entry_if_present(target_step); if (!target_entry) continue; // 2. If targetEntry is navigable's current session history entry and targetEntry's document state's reload pending is false, then: if (target_entry == navigable->current_session_history_entry() && !target_entry->document_state()->reload_pending()) { // 1. Append navigable to results. results.append(navigable); // 2. Extend navigablesToCheck with navigable's child navigables. navigables_to_check.extend(navigable->child_navigables()); } } // 4. Return results. return results; } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-all-navigables-that-might-experience-a-cross-document-traversal Vector> TraversableNavigable::get_all_navigables_that_might_experience_a_cross_document_traversal(int target_step) const { // NOTE: From traversable's session history traversal queue's perspective, these documents are candidates for going cross-document during the // traversal described by targetStep. They will not experience a cross-document traversal if the status code for their target document is // HTTP 204 No Content. // Note that if a given navigable might experience a cross-document traversal, this algorithm will return navigable but not its child navigables. // Those would end up unloaded, not traversed. // 1. Let results be an empty list. Vector> results; // 2. Let navigablesToCheck be « traversable ». Vector> navigables_to_check; navigables_to_check.append(const_cast(*this)); // 3. For each navigable of navigablesToCheck: while (!navigables_to_check.is_empty()) { auto navigable = navigables_to_check.take_first(); // 1. Let targetEntry be the result of getting the target history entry given navigable and targetStep. auto target_entry = navigable->get_the_target_history_entry_if_present(target_step); if (!target_entry) continue; // 2. If targetEntry's document is not navigable's document or targetEntry's document state's reload pending is true, then append navigable to results. // NOTE: Although navigable's active history entry can change synchronously, the new entry will always have the same Document, // so accessing navigable's document is reliable. if (target_entry->document_state()->document_id() != navigable->active_document_id() || target_entry->document_state()->reload_pending()) { results.append(navigable); } // 3. Otherwise, extend navigablesToCheck with navigable's child navigables. // Adding child navigables to navigablesToCheck means those navigables will also be checked by this loop. // Child navigables are only checked if the navigable's active document will not change as part of this traversal. else { navigables_to_check.extend(navigable->child_navigables()); } } // 4. Return results. return results; } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#deactivate-a-document-for-a-cross-document-navigation static void deactivate_a_document_for_cross_document_navigation(GC::Ref displayed_document, Optional, NonnullRefPtr target_entry, GC::Ptr populated_document, GC::Ref> after_potential_unloads) { // 1. Let navigable be displayedDocument's node navigable. auto navigable = displayed_document->navigable(); // 2. Let potentiallyTriggerViewTransition be false. auto potentially_trigger_view_transition = false; // FIXME: 3. Let isBrowserUINavigation be true if userNavigationInvolvement is "browser UI"; otherwise false. // FIXME: 4. Set potentiallyTriggerViewTransition to the result of calling can navigation trigger a cross-document // view-transition? given displayedDocument, targetEntry's document, navigationType, and isBrowserUINavigation. // 5. If potentiallyTriggerViewTransition is false, then: if (!potentially_trigger_view_transition) { // FIXME: 1. Let firePageSwapBeforeUnload be the following step // 1. Fire the pageswap event given displayedDocument, targetEntry, navigationType, and null. // 2. Set the ongoing navigation for navigable to null. navigable->set_ongoing_navigation({}); // 3. Unload a document and its descendants given displayedDocument, targetEntry's document, afterPotentialUnloads, and firePageSwapBeforeUnload. (void)target_entry; // FIXME: Used by pageswap and view-transition steps above. displayed_document->unload_a_document_and_its_descendants(populated_document, after_potential_unloads); } // FIXME: 6. Otherwise, queue a global task on the navigation and traversal task source given navigable's active window to run the steps: else { // FIXME: 1. Let proceedWithNavigationAfterViewTransitionCapture be the following step: // 1. Append the following session history traversal steps to navigable's traversable navigable: // 1. Set the ongoing navigation for navigable to null. // 2. Unload a document and its descendants given displayedDocument, targetEntry's document, and afterPotentialUnloads. // FIXME: 2. Let viewTransition be the result of setting up a cross-document view-transition given displayedDocument, // targetEntry's document, navigationType, and proceedWithNavigationAfterViewTransitionCapture. // FIXME: 3. Fire the pageswap event given displayedDocument, targetEntry, navigationType, and viewTransition. // FIXME: 4. If viewTransition is null, then run proceedWithNavigationAfterViewTransitionCapture. TODO(); } } struct ChangingNavigableContinuationState : public JS::Cell { GC_CELL(ChangingNavigableContinuationState, JS::Cell); GC_DECLARE_ALLOCATOR(ChangingNavigableContinuationState); GC::Ptr displayed_document; Optional displayed_document_id; RefPtr target_entry; GC::Ptr navigable; bool update_only = false; GC::Ptr population_output; GC::Ptr resolved_document; Optional old_origin; virtual void visit_edges(Cell::Visitor& visitor) override { Base::visit_edges(visitor); visitor.visit(displayed_document); visitor.visit(navigable); visitor.visit(population_output); visitor.visit(resolved_document); } }; GC_DEFINE_ALLOCATOR(ChangingNavigableContinuationState); static void queue_apply_history_step_task(GC::Ref navigable, GC::Ptr top_level_document, GC::Ref> steps) { // AD-HOC: Queue top-level tasks with the active Document instead of using queue_global_task(active_window). // During initial about:blank Window reuse, active_window()->associated_document() can already be the // pending Document, but the apply-history task must run against the current active Document. // // Child navigables can destroy or deactivate their active Document before the queued task runs, causing // document-associated tasks to be dropped. Queue child tasks with a null Document so the task remains // runnable, and revalidate the child navigable inside the task. auto task_document = navigable->is_top_level_traversable() ? top_level_document : GC::Ptr {}; queue_a_task(Task::Source::NavigationAndTraversal, nullptr, task_document, steps); } class ApplyHistoryStepState : public GC::Cell { GC_CELL(ApplyHistoryStepState, GC::Cell); GC_DECLARE_ALLOCATOR(ApplyHistoryStepState); public: static constexpr int TIMEOUT_MS = 15000; ApplyHistoryStepState( GC::Ref traversable, int step, int target_step, GC::Ptr source_snapshot_params, UserNavigationInvolvement user_involvement, Optional navigation_type, TraversableNavigable::SynchronousNavigation synchronous_navigation, Navigable::NavigationAPIAbortBehavior navigation_api_abort_behavior, GC::Ptr pending_document, GC::Ptr expected_ongoing_navigation_navigable, Optional expected_ongoing_navigation_id, GC::Ref on_complete) : m_traversable(traversable) , m_step(step) , m_target_step(target_step) , m_source_snapshot_params(source_snapshot_params) , m_user_involvement(user_involvement) , m_navigation_type(navigation_type) , m_synchronous_navigation(synchronous_navigation) , m_navigation_api_abort_behavior(navigation_api_abort_behavior) , m_pending_document(pending_document) , m_expected_ongoing_navigation_navigable(expected_ongoing_navigation_navigable) , m_expected_ongoing_navigation_id(move(expected_ongoing_navigation_id)) , m_on_complete(on_complete) , m_timeout(Platform::Timer::create_single_shot(heap(), TIMEOUT_MS, GC::create_function(heap(), [this] { if (m_phase != Phase::Completed) { dbgln("FIXME: ApplyHistoryStepState timed out in phase {} step={} changing={}/{} completed={}/{} cont={}/{} non_changing={}/{} url={}", to_underlying(m_phase), m_step, m_changing_navigables.size(), m_changing_navigables.size(), m_completed_change_jobs, m_changing_navigables.size(), m_continuation_index, m_continuations.size(), m_completed_non_changing_jobs, m_non_changing_navigables.size(), m_traversable->active_document() ? m_traversable->active_document()->url() : URL::URL {}); } }))) { m_timeout->start(); } void start(); void did_receive_continuation(GC::Ref continuation) { m_continuations.append(continuation); signal_progress(); } void signal_progress() { switch (m_phase) { case Phase::WaitingForDocumentPopulation: // Population progress is tracked by m_continuations.size() + m_completed_change_jobs. // The caller either appended a continuation or incremented m_completed_change_jobs before calling. break; case Phase::ProcessingContinuations: case Phase::WaitingForChangeJobCompletion: ++m_completed_change_jobs; break; case Phase::WaitingForNonChangingJobs: ++m_completed_non_changing_jobs; break; case Phase::Completed: return; } try_advance(); } enum class Phase { WaitingForDocumentPopulation, ProcessingContinuations, WaitingForChangeJobCompletion, WaitingForNonChangingJobs, Completed, }; private: void visit_edges(Cell::Visitor& visitor) override { Base::visit_edges(visitor); visitor.visit(m_traversable); visitor.visit(m_source_snapshot_params); visitor.visit(m_pending_document); visitor.visit(m_expected_ongoing_navigation_navigable); visitor.visit(m_on_complete); visitor.visit(m_timeout); visitor.visit(m_changing_navigables); visitor.visit(m_non_changing_navigables); visitor.visit(m_continuations); for (auto& navigable : m_navigables_that_must_wait_before_handling_sync_navigation) visitor.visit(navigable); } void try_advance() { switch (m_phase) { case Phase::WaitingForDocumentPopulation: if (m_continuations.size() + m_completed_change_jobs == m_changing_navigables.size()) { m_phase = Phase::ProcessingContinuations; process_continuations(); } break; case Phase::ProcessingContinuations: case Phase::WaitingForChangeJobCompletion: if (m_completed_change_jobs == m_changing_navigables.size() && m_continuation_index >= m_continuations.size()) { m_phase = Phase::WaitingForNonChangingJobs; enter_waiting_for_non_changing_jobs(); } break; case Phase::WaitingForNonChangingJobs: if (m_completed_non_changing_jobs == m_non_changing_navigables.size()) complete(); break; case Phase::Completed: break; } } void process_continuations(); void enter_waiting_for_non_changing_jobs(); void complete(); void finish_without_applying(); void complete_change_job_without_applying(GC::Ptr); bool changing_navigable_is_still_current(GC::Ptr, Optional expected_active_document_id) const; void clear_ongoing_traversal_for_changing_navigable(GC::Ptr); void clear_ongoing_traversals_for_changing_navigables(); Phase m_phase { Phase::WaitingForDocumentPopulation }; GC::Ref m_traversable; int m_step; int m_target_step; GC::Ptr m_source_snapshot_params; UserNavigationInvolvement m_user_involvement; Optional m_navigation_type; TraversableNavigable::SynchronousNavigation m_synchronous_navigation; Navigable::NavigationAPIAbortBehavior m_navigation_api_abort_behavior; GC::Ptr m_pending_document; GC::Ptr m_expected_ongoing_navigation_navigable; Optional m_expected_ongoing_navigation_id; GC::Ptr m_on_complete; GC::Ref m_timeout; Vector> m_changing_navigables; Vector> m_non_changing_navigables; size_t m_completed_change_jobs { 0 }; Vector> m_continuations; size_t m_continuation_index { 0 }; RefPtr> m_pending_sync_nav_promise; HashTable> m_navigables_that_must_wait_before_handling_sync_navigation; size_t m_completed_non_changing_jobs { 0 }; }; GC_DEFINE_ALLOCATOR(ApplyHistoryStepState); void ApplyHistoryStepState::start() { if (expected_ongoing_navigation_was_superseded(m_expected_ongoing_navigation_navigable, m_expected_ongoing_navigation_id)) { // NB: A cross-document navigation can be superseded after its document has populated but before its queued // history-step application runs. The navigate algorithm's earlier navigation ID check caught the same // condition before appending these steps; this re-check keeps a stale finalization from claiming // "traversal" and canceling the newer navigation. finish_without_applying(); return; } // 7. Let nonchangingNavigablesThatStillNeedUpdates be the result of getting all navigables that only need history object length/index update given traversable and targetStep. auto non_changing_navigables = m_traversable->get_all_navigables_that_only_need_history_object_length_index_update(m_target_step); for (auto& nav : non_changing_navigables) m_non_changing_navigables.append(*nav); // 8. For each navigable of changingNavigables: auto changing_navigables = m_traversable->get_all_navigables_whose_current_session_history_entry_will_change_or_reload(m_target_step); for (auto& navigable : changing_navigables) { if (m_synchronous_navigation == TraversableNavigable::SynchronousNavigation::Yes && synchronous_same_document_navigation_must_preserve_ongoing_navigation(*navigable)) { continue; } // https://html.spec.whatwg.org/multipage/document-sequences.html#creating-a-new-child-navigable // NB: The creation/destruction update is the bookkeeping step after the child's nested history has been // attached to its parent document state. If the container's requested navigation has already started, it // owns the ongoing navigation ID and eventual document activation. if (!m_navigation_type.has_value() && navigable->ongoing_navigation().has()) continue; // 1. Let targetEntry be the result of getting the target history entry given navigable and targetStep. auto target_entry = navigable->get_the_target_history_entry_if_present(m_target_step); if (!target_entry) continue; // https://html.spec.whatwg.org/multipage/nav-history-apis.html#fire-a-traverse-navigate-event // NB: Same-document traversals are synchronous in browser engines, but the specification routes them through // the traversal queue. If a later cross-document navigation has already claimed the navigable by the time // this queued same-document traversal reaches its bookkeeping step, do not replace that navigation's ID // with "traversal". The queued traversal is stale reconciliation at that point, and must not cancel the // newer navigation. if (m_navigation_type == Bindings::NavigationType::Traverse && navigable->ongoing_navigation().has() && target_entry->document_state()->document_id() == navigable->active_document_id()) { continue; } // 2. Set navigable's current session history entry to targetEntry. navigable->set_current_session_history_entry(target_entry); // 3. Set navigable's ongoing navigation to "traversal". navigable->set_ongoing_navigation(HTML::Navigable::Traversal::Tag, m_navigation_api_abort_behavior); m_changing_navigables.append(*navigable); } // 12. For each navigable of changingNavigables, queue a global task on the navigation and traversal task source. for (auto& navigable : m_changing_navigables) { // AD-HOC: If the navigable has been destroyed, or has no active window, skip it. // We must increment completed_change_jobs here rather than relying on the queued // task, because Document::destroy() removes tasks associated with a document from // the task queue, which can cause those tasks to never run. if (navigable->has_been_destroyed() || !navigable->active_window()) { complete_change_job_without_applying(navigable); continue; } auto expected_target_entry = navigable->current_session_history_entry(); queue_apply_history_step_task(*navigable, navigable->active_document(), GC::create_function(heap(), [this, navigable, expected_target_entry] { // NOTE: This check is not in the spec but we should not continue navigation if navigable has been destroyed. if (navigable->has_been_destroyed() || !navigable->active_window() || !navigable->active_document()) { complete_change_job_without_applying(navigable); return; } // 1. Let displayedEntry be navigable's active session history entry. auto displayed_entry = navigable->active_session_history_entry(); // 2. Let targetEntry be navigable's current session history entry. auto target_entry = navigable->current_session_history_entry(); if (!target_entry || target_entry != expected_target_entry) { // AD-HOC: The HTML Standard expects the session history traversal queue to serialize this task with // later navigations. Our web-compatible deferral of navigations that arrive during traversal // can let a newer navigation replace the current entry before this task runs. Treat this state // as stale instead of applying its old target step after the newer navigation. finish_without_applying(); return; } auto displayed_step = displayed_entry ? displayed_entry->step_value() : Optional {}; auto target_step = target_entry ? target_entry->step_value() : Optional {}; if (!displayed_step.has_value() || !target_step.has_value()) { // NB: Child navigables created during a busy top-level navigation can still have a pending initial // session history entry. The spec's step-based history algorithms operate on used history steps, // so a pending child entry must not block or crash the top-level apply-history step. The queued // child creation/destruction history step will reconcile the child once it has a concrete step. complete_change_job_without_applying(navigable); return; } // 3. Let changingNavigableContinuation be a changing navigable continuation state with: auto changing_navigable_continuation = heap().allocate(); changing_navigable_continuation->displayed_document = navigable->active_document(); changing_navigable_continuation->displayed_document_id = navigable->active_document_id(); changing_navigable_continuation->target_entry = target_entry; changing_navigable_continuation->navigable = navigable; changing_navigable_continuation->update_only = false; changing_navigable_continuation->population_output = nullptr; // 4. If displayedEntry is targetEntry and targetEntry's document state's reload pending is false, then: // AD-HOC: A synchronous same-document navigation has already updated the active entry by this point. // A later queued reload can additionally set reload pending on an already-active target entry // before that synchronous step is applied. The reload step owns that population work. bool is_update_only = displayed_entry == target_entry && !target_entry->document_state()->reload_pending(); if (m_synchronous_navigation == TraversableNavigable::SynchronousNavigation::Yes) is_update_only = !target_entry->document_state()->reload_pending() || displayed_entry == target_entry; if (is_update_only) { // 1. Set changingNavigableContinuation's update-only to true. changing_navigable_continuation->update_only = true; changing_navigable_continuation->resolved_document = navigable->active_document(); // 2. Enqueue changingNavigableContinuation on changingNavigableContinuations. did_receive_continuation(changing_navigable_continuation); // 3. Abort these steps. return; } // 5. Switch on navigationType: if (m_navigation_type.has_value()) { switch (m_navigation_type.value()) { case Bindings::NavigationType::Reload: // - "reload": Assert: targetEntry's document state's reload pending is true. VERIFY(target_entry->document_state()->reload_pending()); break; case Bindings::NavigationType::Traverse: // - "traverse": Assert: targetEntry's document state's ever populated is true. VERIFY(target_entry->document_state()->ever_populated()); break; case Bindings::NavigationType::Replace: // FIXME: Add ever populated check // - "replace": Assert: targetEntry's step is displayedEntry's step and targetEntry's document state's ever populated is false. VERIFY(target_entry->step() == displayed_entry->step()); break; case Bindings::NavigationType::Push: // FIXME: Add ever populated check, and fix the bug where top level traversable's step is not updated when a child navigable navigates // - "push": Assert: targetEntry's step is displayedEntry's step + 1 and targetEntry's document state's ever populated is false. if (*target_step <= *displayed_step) { // AD-HOC: A queued push can become stale if a later navigation commits before this task runs. // Browser engines let the later navigation win; do the same and avoid moving the // traversable's current step back to this push target during completion. finish_without_applying(); return; } VERIFY(target_entry != displayed_entry); break; } } // 6. Let oldOrigin be targetEntry's document state's origin. auto old_origin = target_entry->document_state()->origin(); // 7. If all of the following are true: // * navigable is not traversable; // * targetEntry is not navigable's current session history entry; and // * oldOrigin is the same as navigable's current session history entry's document state's origin, // then: if (!navigable->is_traversable() && target_entry != navigable->current_session_history_entry() && old_origin == navigable->current_session_history_entry()->document_state()->origin()) { // 1. Let navigation be navigable's active window's navigation API. auto navigation = m_traversable->active_window()->navigation(); // 2. Fire a traverse navigate event at navigation given targetEntry and userInvolvement. navigation->fire_a_traverse_navigate_event(*target_entry, m_user_involvement); } auto after_document_populated = GC::create_function(heap(), [this, old_origin, changing_navigable_continuation, target_entry, navigable](GC::Ptr output) mutable { changing_navigable_continuation->population_output = output; changing_navigable_continuation->old_origin = old_origin; // Compute the resolved document: pending_document (from finalize path), // population output (from traversal path), or active document (same-document). GC::Ptr resolved_document; if (m_pending_document) resolved_document = m_pending_document; else if (output && output->document) resolved_document = output->document; else resolved_document = navigable->active_document(); changing_navigable_continuation->resolved_document = resolved_document; // 1. If targetEntry's document is null, then set changingNavigableContinuation's update-only to true. bool has_fresh_document = m_pending_document || (output && output->document); if (!has_fresh_document && target_entry->document_state()->document_id() != navigable->active_document_id()) changing_navigable_continuation->update_only = true; // 2. If targetEntry's document's origin is not oldOrigin, then set targetEntry's classic history API state to StructuredSerializeForStorage(null). // 3. If all of the following are true: // - navigable's parent is null; // - targetEntry's document's browsing context is not an auxiliary browsing context whose opener browsing context is non-null; and // - targetEntry's document's origin is not oldOrigin, // then set targetEntry's document state's navigable target name to the empty string. // NOTE: Steps 2-3 are deferred to after_potential_unload to avoid exposing mutations during unload. // 4. Enqueue changingNavigableContinuation on changingNavigableContinuations. did_receive_continuation(changing_navigable_continuation); }); // 8. If targetEntry's document is null, or targetEntry's document state's reload pending is true, then: bool needs_population = !m_pending_document && (target_entry->document_state()->document_id() != navigable->active_document_id() || target_entry->document_state()->reload_pending()); if (needs_population) { if (target_entry->document_state()->reload_pending() && navigable->is_top_level_traversable()) navigable->page().client().page_did_start_loading(target_entry->url(), Empty {}, false); // FIXME: 1. Let navTimingType be "back_forward" if targetEntry's document is null; otherwise "reload". // 2. Let targetSnapshotParams be the result of snapshotting target snapshot params given navigable. auto target_snapshot_params = navigable->snapshot_target_snapshot_params(); // 3. Let potentiallyTargetSpecificSourceSnapshotParams be sourceSnapshotParams. auto potentially_target_specific_source_snapshot_params = m_source_snapshot_params; // 4. If potentiallyTargetSpecificSourceSnapshotParams is null, then set it to the result of snapshotting source snapshot params given navigable's active document. if (!potentially_target_specific_source_snapshot_params) potentially_target_specific_source_snapshot_params = navigable->active_document()->snapshot_source_snapshot_params(); // 5. Set targetEntry's document state's reload pending to false. target_entry->document_state()->set_reload_pending(false); // 6. Let allowPOST be targetEntry's document state's reload pending. auto allow_POST = target_entry->document_state()->reload_pending(); // https://github.com/whatwg/html/issues/9869 // Population runs in a deferred task, during which sync navigations can mutate // the live entry. Snapshot the input fields now so population reads stable values. auto input_url = target_entry->url(); auto input_document_resource = target_entry->document_state()->resource(); auto input_request_referrer = target_entry->document_state()->request_referrer(); auto input_request_referrer_policy = target_entry->document_state()->request_referrer_policy(); auto input_initiator_origin = target_entry->document_state()->initiator_origin(); auto input_origin = target_entry->document_state()->origin(); auto input_history_policy_container = target_entry->document_state()->history_policy_container(); auto input_about_base_url = target_entry->document_state()->about_base_url(); auto input_navigable_target_name = target_entry->document_state()->navigable_target_name(); auto input_ever_populated = target_entry->document_state()->ever_populated(); // 7. In parallel, attempt to populate the history entry's document for targetEntry, given navigable, potentiallyTargetSpecificSourceSnapshotParams, // targetSnapshotParams, userInvolvement, with allowPOST set to allowPOST and completionSteps set to // queue a global task on the navigation and traversal task source given navigable's active window to // run afterDocumentPopulated. Platform::EventLoopPlugin::the().deferred_invoke(GC::create_function(heap(), [input_url = move(input_url), input_document_resource = move(input_document_resource), input_request_referrer = move(input_request_referrer), input_request_referrer_policy, input_initiator_origin = move(input_initiator_origin), input_origin = move(input_origin), input_history_policy_container = move(input_history_policy_container), input_about_base_url = move(input_about_base_url), input_navigable_target_name = move(input_navigable_target_name), input_ever_populated, potentially_target_specific_source_snapshot_params, target_snapshot_params, this, allow_POST, navigable, after_document_populated, user_involvement = m_user_involvement] { navigable->populate_session_history_entry_document( move(input_url), move(input_document_resource), move(input_request_referrer), input_request_referrer_policy, move(input_initiator_origin), move(input_origin), input_history_policy_container, move(input_about_base_url), move(input_navigable_target_name), false, input_ever_populated, *potentially_target_specific_source_snapshot_params, target_snapshot_params, user_involvement, {}, Navigable::NullOrError {}, ContentSecurityPolicy::Directives::Directive::NavigationType::Other, allow_POST, GC::create_function(this->heap(), [this, after_document_populated, navigable](GC::Ptr output) { VERIFY(m_traversable->active_window()); // AD-HOC: Queue with navigable's active Document instead of using queue_global_task(active_window). // During initial about:blank Window reuse, active_window()->associated_document() can already be // the pending Document. This continuation must stay runnable against the current active Document. queue_a_task(Task::Source::NavigationAndTraversal, nullptr, navigable->active_document(), GC::create_function(heap(), [after_document_populated, output]() { after_document_populated->function()(output); })); })); })); } // Otherwise, run afterDocumentPopulated immediately. else { after_document_populated->function()(nullptr); } })); } try_advance(); } void ApplyHistoryStepState::process_continuations() { for (;;) { // NOTE: Synchronous navigations that are intended to take place before this traversal jump the queue at this point, // so they can be added to the correct place in traversable's session history entries before this traversal // potentially unloads their document. More details can be found here (https://html.spec.whatwg.org/multipage/browsing-the-web.html#sync-navigation-steps-queue-jumping-examples) // 1. If traversable's running nested apply history step is false, then: if (!m_traversable->m_paused_apply_history_step_state) { // 1. While traversable's session history traversal queue's algorithm set contains one or more synchronous // navigation steps with a target navigable not contained in navigablesThatMustWaitBeforeHandlingSyncNavigation: // 1. Let steps be the first item in traversable's session history traversal queue's algorithm set // that is synchronous navigation steps with a target navigable not contained in navigablesThatMustWaitBeforeHandlingSyncNavigation. // 2. Remove steps from traversable's session history traversal queue's algorithm set. while (true) { auto entry = m_traversable->m_session_history_traversal_queue->first_synchronous_navigation_steps_with_target_navigable_not_contained_in(m_navigables_that_must_wait_before_handling_sync_navigation); if (!entry) break; VERIFY(!m_traversable->m_paused_apply_history_step_state); m_traversable->m_paused_apply_history_step_state = this; // 4. Run steps. auto promise = Core::Promise::construct(); entry->execute_steps(promise); // GC safety: `this` is kept alive by m_paused_apply_history_step_state (visited). // The promise is kept alive by m_pending_sync_nav_promise (RefPtr). VERIFY(!m_pending_sync_nav_promise); m_pending_sync_nav_promise = promise; promise->when_resolved([this](Empty) { // 5. Set traversable's running nested apply history step to false. VERIFY(m_pending_sync_nav_promise); m_pending_sync_nav_promise = nullptr; m_traversable->m_apply_history_step_state = this; m_traversable->m_paused_apply_history_step_state = nullptr; process_continuations(); }); return; } } if (m_continuation_index == m_continuations.size()) { if (m_phase == Phase::ProcessingContinuations) { m_phase = Phase::WaitingForChangeJobCompletion; try_advance(); } return; } // 3. If changingNavigableContinuation is nothing, then continue. auto continuation = m_continuations[m_continuation_index++]; // 4. Let displayedDocument be changingNavigableContinuation's displayed document. auto displayed_document = continuation->displayed_document; // 5. Let targetEntry be changingNavigableContinuation's target entry. auto population_output = continuation->population_output; auto old_origin = continuation->old_origin; // 6. Let navigable be changingNavigableContinuation's navigable. auto navigable = continuation->navigable; // AD-HOC: We should not continue navigation if navigable has been destroyed. if (navigable->has_been_destroyed()) { signal_progress(); continue; } // AD-HOC: The displayed document may have been destroyed during the nested step execution above. if (!displayed_document->navigable()) { signal_progress(); continue; } m_target_step = m_traversable->get_the_used_step(m_step); // 7. Let (scriptHistoryLength, scriptHistoryIndex) be the result of getting the history object length and index given traversable and targetStep. auto history_object_length_and_index = m_traversable->get_the_history_object_length_and_index(m_target_step); auto script_history_length = history_object_length_and_index.script_history_length; auto script_history_index = history_object_length_and_index.script_history_index; // 8. Append navigable to navigablesThatMustWaitBeforeHandlingSyncNavigation. m_navigables_that_must_wait_before_handling_sync_navigation.set(*navigable); // 9. Let entriesForNavigationAPI be the result of getting session history entries for the navigation API given navigable and targetStep. auto entries_for_navigation_api = m_traversable->get_session_history_entries_for_the_navigation_api(*navigable, m_target_step); // NOTE: Steps 10 and 11 come after step 12. // 12. In both cases, let afterPotentialUnloads be the following steps: bool const update_only = continuation->update_only; RefPtr const target_entry = continuation->target_entry; auto const displayed_document_id = continuation->displayed_document_id; auto after_potential_unload = GC::create_function(heap(), [this, navigable, update_only, target_entry, continuation, population_output, old_origin, displayed_document_id, script_history_length, script_history_index, entries_for_navigation_api = move(entries_for_navigation_api), navigation_type = m_navigation_type] { if (update_only || continuation->resolved_document.ptr() == continuation->displayed_document.ptr()) { // AD-HOC: Child navigable same-document/update-only tasks are queued without an associated Document so // they can survive the old active Document being deactivated. That also lets them run after the // child frame was destroyed or after a newer navigation claimed the frame. Browser engines let // the newer frame state win, so skip this stale continuation in that case. if (!changing_navigable_is_still_current(navigable, displayed_document_id)) { complete_change_job_without_applying(navigable); return; } } if (population_output) population_output->apply_to(*target_entry); // Post-population adjustments — only run when a fresh document was produced // (not for 204/205 no-document outcomes where resolved_document is the old active document). bool has_fresh_document = m_pending_document || (population_output && population_output->document); if (has_fresh_document) { auto resolved_document = continuation->resolved_document; // 2. If targetEntry's document's origin is not oldOrigin, then set targetEntry's classic history API state to StructuredSerializeForStorage(null). if (resolved_document->origin() != old_origin) { auto& vm = navigable->vm(); target_entry->set_classic_history_api_state(MUST(structured_serialize_for_storage(vm, JS::js_null()))); } // 3. If all of the following are true: // - navigable's parent is null; // - targetEntry's document's browsing context is not an auxiliary browsing context whose opener browsing context is non-null; and // - targetEntry's document's origin is not oldOrigin, // then set targetEntry's document state's navigable target name to the empty string. if (navigable->parent() == nullptr && !(resolved_document->browsing_context()->is_auxiliary() && resolved_document->browsing_context()->opener_browsing_context() != nullptr) && target_entry->document_state()->origin() != old_origin) { target_entry->document_state()->set_navigable_target_name(String {}); } } // 1. Let previousEntry be navigable's active session history entry. auto previous_entry = navigable->active_session_history_entry(); // 2. If changingNavigableContinuation's update-only is false, then activate history entry targetEntry for navigable. auto resolved_document = continuation->resolved_document; if (!update_only) navigable->activate_history_entry(*target_entry, *resolved_document); // 3. Let updateDocument be an algorithm step which performs update document for history step application given // targetEntry's document, targetEntry, changingNavigableContinuation's update-only, scriptHistoryLength, // scriptHistoryIndex, navigationType, entriesForNavigationAPI, and previousEntry. auto update_document = [script_history_length, script_history_index, entries_for_navigation_api = move(entries_for_navigation_api), target_entry, update_only, navigation_type, previous_entry, resolved_document] { resolved_document->update_for_history_step_application(*target_entry, update_only, script_history_length, script_history_index, navigation_type, entries_for_navigation_api, previous_entry, navigation_type.has_value()); }; // 4. If targetEntry's document is equal to displayedDocument, then perform updateDocument. // NOTE: We compare against the pre-activation displayed_document_id (not the current // active entry) because activate_history_entry() has already updated the active entry above. if (target_entry->document_state()->document_id() == displayed_document_id) { update_document(); } // AD-HOC: When the document already has its parser pre-loaded with in-memory data (currently set up // only for about:srcdoc), perform updateDocument synchronously instead of queueing it. // updateDocument calls Document::set_ready_to_run_scripts(), which kicks off the deferred // parser. Running it in the same task as activation guarantees the body element exists before // script in the parent navigable can observe the new document — matching Chrome and Firefox // behavior for srcdoc iframes. else if (resolved_document->has_deferred_parser_start()) { update_document(); } // 5. Otherwise, queue a global task on the navigation and traversal task source given targetEntry's document's relevant global object to perform updateDocument else { queue_global_task(Task::Source::NavigationAndTraversal, relevant_global_object(*resolved_document), GC::create_function(heap(), move(update_document))); } // 6. Increment completedChangeJobs. signal_progress(); }); // 10. If changingNavigableContinuation's update-only is true, or targetEntry's document is displayedDocument, then: if (continuation->update_only || continuation->resolved_document.ptr() == displayed_document.ptr()) { // 1. Set the ongoing navigation for navigable to null. navigable->set_ongoing_navigation({}, m_navigation_api_abort_behavior); // 2. Queue a global task on the navigation and traversal task source given navigable's active window to perform afterPotentialUnloads. queue_apply_history_step_task(*navigable, navigable->active_document(), after_potential_unload); } // AD-HOC: During navigable creation, the initial about:blank document can be // replaced by the container's initial navigation while applying the // creation/destruction history step. That hook passes a null // navigationType per spec, and there is no outgoing document to unload. else if (!m_navigation_type.has_value() && displayed_document->is_initial_about_blank()) { navigable->set_ongoing_navigation({}, m_navigation_api_abort_behavior); after_potential_unload->function()(); } // 11. Otherwise: else { // 1. Assert: navigationType is not null. VERIFY(m_navigation_type.has_value()); // 2. Deactivate displayedDocument, given userInvolvement, targetEntry, navigationType, and afterPotentialUnloads. deactivate_a_document_for_cross_document_navigation(*displayed_document, m_user_involvement, *target_entry, continuation->resolved_document, after_potential_unload); } } } void ApplyHistoryStepState::enter_waiting_for_non_changing_jobs() { m_target_step = m_traversable->get_the_used_step(m_step); // 17. Let (scriptHistoryLength, scriptHistoryIndex) be the result of getting the history object length and index given traversable and targetStep. auto length_and_index = m_traversable->get_the_history_object_length_and_index(m_target_step); auto script_history_length = length_and_index.script_history_length; auto script_history_index = length_and_index.script_history_index; // 18. For each navigable of nonchangingNavigablesThatStillNeedUpdates, queue a global task on the navigation and traversal task source given navigable's active window to run the steps: for (auto& navigable : m_non_changing_navigables) { // AD-HOC: This check is not in the spec but we should not continue navigation if navigable has been destroyed, // or if there's no active window. if (navigable->has_been_destroyed() || !navigable->active_window()) { ++m_completed_non_changing_jobs; continue; } // AD-HOC: Queue with null document instead of using queue_global_task. // Tasks associated with a document are only runnable when fully active. // In the async state machine, documents can become non-fully-active between // queue time and execution, causing the task to be permanently stuck. // A null-document task is always runnable; we check validity inside. queue_a_task(Task::Source::NavigationAndTraversal, nullptr, nullptr, GC::create_function(heap(), [this, navigable, script_history_length, script_history_index] { if (navigable->has_been_destroyed() || !navigable->active_window() || !navigable->active_document()->is_fully_active()) { signal_progress(); return; } // 1. Let document be navigable's active document. auto document = navigable->active_document(); // 2. Set document's history object's index to scriptHistoryIndex. document->history()->m_index = script_history_index; // 3. Set document's history object's length to scriptHistoryLength. document->history()->m_length = script_history_length; // 4. Increment completedNonchangingJobs. signal_progress(); })); } try_advance(); } TraversableNavigable::SessionHistorySnapshot TraversableNavigable::create_session_history_snapshot(SaveActiveEntryPersistedState save_active_entry_persisted_state) { if (save_active_entry_persisted_state == SaveActiveEntryPersistedState::Yes) save_persisted_state_to_active_session_history_entry(); Vector top_level_session_history_entries; top_level_session_history_entries.ensure_capacity(session_history_entries().size()); SessionHistoryEntryDescriptorCreationState creation_state; for (auto const& entry : session_history_entries()) top_level_session_history_entries.unchecked_append(create_session_history_entry_descriptor(entry, creation_state)); auto used_history_steps = get_all_used_history_steps(); Vector used_session_history_steps; used_session_history_steps.ensure_capacity(used_history_steps.size()); auto current_session_history_step_for_snapshot = current_session_history_step(); if (!used_history_steps.contains_slow(current_session_history_step_for_snapshot)) { // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-the-used-step // NB: The UI process snapshot needs a current item from the used-steps list. While the // creation/destruction update is reconciling removed child navigables, the traversable's current // session history step can be a hole. Use the same greatest-used-step <= current step rule here only; // traversal and back/forward decisions still use the spec's current-step-in-allSteps assertions. current_session_history_step_for_snapshot = get_the_used_step(current_session_history_step_for_snapshot); } Optional current_used_step_index; for (size_t i = 0; i < used_history_steps.size(); ++i) { auto step = used_history_steps[i]; used_session_history_steps.unchecked_append(static_cast(step)); if (step == current_session_history_step_for_snapshot) current_used_step_index = i; } VERIFY(current_used_step_index.has_value()); return { .top_level_session_history_entries = move(top_level_session_history_entries), .used_session_history_steps = move(used_session_history_steps), .current_used_step_index = *current_used_step_index, }; } void ApplyHistoryStepState::complete() { if (m_phase == Phase::Completed) return; m_phase = Phase::Completed; m_timeout->stop(); // https://html.spec.whatwg.org/multipage/browsing-the-web.html#getting-the-used-step // NB: targetStep was computed before the asynchronous portions of applying the history step. If a child // navigable was removed while those steps were running, that step can stop being used. Normalize again // before storing it as the traversable's current session history step. m_target_step = m_traversable->get_the_used_step(m_target_step); // 20. Set traversable's current session history step to targetStep. m_traversable->m_current_session_history_step = m_target_step; // AD-HOC: Report the updated session history descriptors to the UI-process mirror. if (m_traversable->page().client().should_report_session_history_updates()) { auto save_active_entry_persisted_state = TraversableNavigable::SaveActiveEntryPersistedState::Yes; // NB: During history traversal, the active entry can point at the target // entry before the active document's queued history-step update has // restored the target entry's persisted state. Do not overwrite that // target entry with the document's pre-restoration viewport offset. if (m_navigation_type == Bindings::NavigationType::Traverse) { auto document = m_traversable->active_document(); auto active_entry = m_traversable->active_session_history_entry(); if (document && active_entry && document->latest_entry() != active_entry) save_active_entry_persisted_state = TraversableNavigable::SaveActiveEntryPersistedState::No; } auto session_history_snapshot = m_traversable->create_session_history_snapshot(save_active_entry_persisted_state); m_traversable->page().client().page_did_update_session_history(session_history_snapshot.top_level_session_history_entries, session_history_snapshot.used_session_history_steps, session_history_snapshot.current_used_step_index); } VERIFY(m_traversable->m_session_history_entries.size() > 0); auto back_enabled = m_traversable->can_go_back(); auto forward_enabled = m_traversable->can_go_forward(); m_traversable->page().client().page_did_update_navigation_buttons_state(back_enabled, forward_enabled); m_traversable->page().client().page_did_change_url(m_traversable->current_session_history_entry()->url()); // Clear state BEFORE on_complete, because on_complete may resolve a promise // that triggers the next session history traversal queue entry. // For nested states, the outer state is restored by the when_resolved callback // on the sync nav step's promise in process_continuations(). m_traversable->m_apply_history_step_state = nullptr; // 21. Return "applied". if (m_on_complete) m_on_complete->function()(HistoryStepResult::Applied); } void ApplyHistoryStepState::finish_without_applying() { if (m_phase == Phase::Completed) return; m_phase = Phase::Completed; m_timeout->stop(); clear_ongoing_traversals_for_changing_navigables(); m_traversable->m_apply_history_step_state = nullptr; if (m_on_complete) m_on_complete->function()(HistoryStepResult::Applied); } void ApplyHistoryStepState::complete_change_job_without_applying(GC::Ptr navigable) { if (m_phase == Phase::Completed) return; clear_ongoing_traversal_for_changing_navigable(navigable); // NB: During document population, signal_progress() only advances the state // machine. Later phases let it own the per-change-job accounting. if (m_phase == Phase::WaitingForDocumentPopulation) ++m_completed_change_jobs; signal_progress(); } bool ApplyHistoryStepState::changing_navigable_is_still_current(GC::Ptr navigable, Optional expected_active_document_id) const { if (!navigable || navigable->has_been_destroyed() || !navigable->active_window()) return false; auto active_document = navigable->active_document(); if (!active_document || active_document->has_been_destroyed()) return false; if (navigable->active_document_id() != expected_active_document_id) return false; return navigable->ongoing_navigation().has(); } void ApplyHistoryStepState::clear_ongoing_traversal_for_changing_navigable(GC::Ptr navigable) { if (!navigable || navigable->has_been_destroyed()) return; if (!navigable->ongoing_navigation().has()) return; // AD-HOC: The HTML Standard's traversal queue normally reaches one of the per-navigable "Set the ongoing // navigation for navigable to null" steps before this state completes. Our stale-task exits deliberately // skip the rest of the history step so newer navigations win like they do in Chromium, WebKit, and Gecko, // but we still have to remove the traversal sentinel. Use the shared setter so pending navigations queued // behind this traversal are drained in one place. navigable->set_ongoing_navigation({}, m_navigation_api_abort_behavior); } void ApplyHistoryStepState::clear_ongoing_traversals_for_changing_navigables() { for (auto& navigable : m_changing_navigables) clear_ongoing_traversal_for_changing_navigable(navigable); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#apply-the-history-step void TraversableNavigable::apply_the_history_step( int step, bool check_for_cancelation, GC::Ptr source_snapshot_params, GC::Ptr initiator_to_check, UserNavigationInvolvement user_involvement, Optional navigation_type, SynchronousNavigation synchronous_navigation, Navigable::NavigationAPIAbortBehavior navigation_api_abort_behavior, GC::Ptr pending_document, GC::Ptr expected_ongoing_navigation_navigable, Optional expected_ongoing_navigation_id, GC::Ref on_complete) { // FIXME: 1. Assert: This is running within traversable's session history traversal queue. VERIFY(!m_apply_history_step_state || m_paused_apply_history_step_state); run_the_history_step_prechecks(step, check_for_cancelation, source_snapshot_params, initiator_to_check, user_involvement, navigation_type, navigation_api_abort_behavior, GC::create_function(heap(), [this, step, source_snapshot_params, user_involvement, navigation_type, synchronous_navigation, pending_document, expected_ongoing_navigation_navigable, expected_ongoing_navigation_id = move(expected_ongoing_navigation_id), on_complete](HistoryStepResult result, int target_step, Navigable::NavigationAPIAbortBehavior navigation_api_abort_behavior) mutable { if (result != HistoryStepResult::Applied) { on_complete->function()(result); return; } // 6. Let changingNavigables be the result of get all navigables whose current session history entry will // change or reload given traversable and targetStep. apply_the_history_step_after_unload_check(step, target_step, source_snapshot_params, user_involvement, navigation_type, synchronous_navigation, navigation_api_abort_behavior, pending_document, expected_ongoing_navigation_navigable, move(expected_ongoing_navigation_id), on_complete); })); } void TraversableNavigable::run_the_history_step_prechecks( int step, bool check_for_cancelation, GC::Ptr source_snapshot_params, GC::Ptr initiator_to_check, UserNavigationInvolvement user_involvement, Optional navigation_type, Navigable::NavigationAPIAbortBehavior navigation_api_abort_behavior, GC::Ref on_complete) { // 2. Let targetStep be the result of getting the used step given traversable and step. auto target_step = get_the_used_step(step); // 3. If initiatorToCheck is not null, then: if (initiator_to_check != nullptr) { // 1. Assert: sourceSnapshotParams is not null. VERIFY(source_snapshot_params); auto target_top_level_entry = get_the_target_history_entry(target_step); if (target_top_level_entry != current_session_history_entry() && !initiator_to_check->allowed_by_sandboxing_to_navigate(*this, *source_snapshot_params)) { on_complete->function()(HistoryStepResult::InitiatorDisallowed, target_step, navigation_api_abort_behavior); return; } // 2. For each navigable of get all navigables whose current session history entry will change or reload: // if initiatorToCheck is not allowed by sandboxing to navigate navigable given sourceSnapshotParams, then return "initiator-disallowed". for (auto const& navigable : get_all_navigables_whose_current_session_history_entry_will_change_or_reload(target_step)) { if (!initiator_to_check->allowed_by_sandboxing_to_navigate(*navigable, *source_snapshot_params)) { on_complete->function()(HistoryStepResult::InitiatorDisallowed, target_step, navigation_api_abort_behavior); return; } } } // 4. Let navigablesCrossingDocuments be the result of getting all navigables that might experience a cross-document traversal given traversable and targetStep. auto navigables_crossing_documents = get_all_navigables_that_might_experience_a_cross_document_traversal(target_step); // NB: Same-document traversals finish their NavigateEvent during the Navigation API entry // update, after currententrychange. Preserve that event while applying the history step. if (navigation_type == Bindings::NavigationType::Traverse && navigables_crossing_documents.is_empty()) navigation_api_abort_behavior = Navigable::NavigationAPIAbortBehavior::Preserve; // 5. If checkForCancelation is true, and the result of checking if unloading is canceled given navigablesCrossingDocuments, traversable, targetStep, // and userInvolvement is not "continue", then return that result. if (check_for_cancelation) { check_if_unloading_is_canceled(navigables_crossing_documents, *this, target_step, user_involvement, GC::create_function(heap(), [target_step, navigation_api_abort_behavior, on_complete](CheckIfUnloadingIsCanceledResult result) mutable { if (result == CheckIfUnloadingIsCanceledResult::CanceledByBeforeUnload) { on_complete->function()(HistoryStepResult::CanceledByBeforeUnload, target_step, navigation_api_abort_behavior); return; } if (result == CheckIfUnloadingIsCanceledResult::CanceledByNavigate) { on_complete->function()(HistoryStepResult::CanceledByNavigate, target_step, navigation_api_abort_behavior); return; } on_complete->function()(HistoryStepResult::Applied, target_step, navigation_api_abort_behavior); })); return; } on_complete->function()(HistoryStepResult::Applied, target_step, navigation_api_abort_behavior); } void TraversableNavigable::apply_the_history_step_after_unload_check( int step, int target_step, GC::Ptr source_snapshot_params, UserNavigationInvolvement user_involvement, Optional navigation_type, SynchronousNavigation synchronous_navigation, Navigable::NavigationAPIAbortBehavior navigation_api_abort_behavior, GC::Ptr pending_document, GC::Ptr expected_ongoing_navigation_navigable, Optional expected_ongoing_navigation_id, GC::Ref> on_complete) { if (expected_ongoing_navigation_was_superseded(expected_ongoing_navigation_navigable, expected_ongoing_navigation_id)) { on_complete->function()(HistoryStepResult::Applied); return; } auto state = heap().allocate(*this, step, target_step, source_snapshot_params, user_involvement, navigation_type, synchronous_navigation, navigation_api_abort_behavior, pending_document, expected_ongoing_navigation_navigable, move(expected_ongoing_navigation_id), on_complete); VERIFY(!m_apply_history_step_state || m_paused_apply_history_step_state); m_apply_history_step_state = state; state->start(); } class CheckUnloadingCanceledState : public GC::Cell { GC_CELL(CheckUnloadingCanceledState, GC::Cell); GC_DECLARE_ALLOCATOR(CheckUnloadingCanceledState); public: using Result = TraversableNavigable::CheckIfUnloadingIsCanceledResult; static constexpr int TIMEOUT_MS = 15000; CheckUnloadingCanceledState( GC::Ptr traversable, Optional user_involvement, GC::Ref> callback) : m_traversable(traversable) , m_user_involvement(user_involvement) , m_callback(callback) , m_timeout(Platform::Timer::create_single_shot(heap(), TIMEOUT_MS, GC::create_function(heap(), [this] { if (!m_completed) { dbgln("FIXME: check_if_unloading_is_canceled timed out"); finish(Result::Continue); } }))) { m_timeout->start(); } virtual void visit_edges(Visitor& visitor) override { Base::visit_edges(visitor); for (auto& doc : m_phase2_documents) visitor.visit(doc); visitor.visit(m_traversable); visitor.visit(m_callback); visitor.visit(m_timeout); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#checking-if-unloading-is-canceled void start(Vector> const& navigables_that_need_before_unload, Optional target_step) { // 1. Let documentsToFireBeforeunload be the active document of each item in navigablesThatNeedBeforeUnload. for (auto& navigable : navigables_that_need_before_unload) m_phase2_documents.append(*navigable->active_document()); // 2. Let unloadPromptShown be false. // 3. Let finalStatus be "continue". // 4. If traversable was given, then: if (m_traversable) { // 1. Assert: targetStep and userInvolvementForNavigateEvent were given. // NOTE: This assertion is enforced by the caller. // 2. Let targetEntry be the result of getting the target history entry given traversable and targetStep. m_target_entry = m_traversable->get_the_target_history_entry(target_step.value()); // 3. If targetEntry is not traversable's current session history entry, and targetEntry's document state's origin is the same as // traversable's current session history entry's document state's origin: if (m_target_entry != m_traversable->current_session_history_entry() && m_target_entry->document_state()->origin() == m_traversable->current_session_history_entry()->document_state()->origin()) { // 1. Let eventsFired be false. // 2. Let needsBeforeunload be true if navigablesThatNeedBeforeUnload contains traversable; otherwise false. m_needs_beforeunload = navigables_that_need_before_unload.find_if([this](auto const& navigable) { return navigable.ptr() == m_traversable.ptr(); }) != navigables_that_need_before_unload.end(); // 3. If needsBeforeunload is true, then remove traversable's active document from documentsToFireBeforeunload. if (m_needs_beforeunload) { m_phase2_documents.remove_first_matching([this](auto& document) { return document.ptr() == m_traversable->active_document().ptr(); }); } start_phase1(); return; } } start_phase2(); } private: void start_phase1() { // 4. Queue a global task on the navigation and traversal task source given traversable's active window to perform the following steps: VERIFY(m_traversable->active_window()); queue_global_task(Task::Source::NavigationAndTraversal, *m_traversable->active_window(), GC::create_function(heap(), [this] { // 1. if needsBeforeunload is true, then: if (m_needs_beforeunload) { // 1. Let (unloadPromptShownForThisDocument, unloadPromptCanceledByThisDocument) be the result of running the steps to fire beforeunload given traversable's active document and false. auto [unload_prompt_shown_for_this_document, unload_prompt_canceled_by_this_document] = m_traversable->active_document()->steps_to_fire_beforeunload(false); // 2. If unloadPromptShownForThisDocument is true, then set unloadPromptShown to true. if (unload_prompt_shown_for_this_document) m_unload_prompt_shown = true; // 3. If unloadPromptCanceledByThisDocument is true, then set finalStatus to "canceled-by-beforeunload". if (unload_prompt_canceled_by_this_document) m_final_status = Result::CanceledByBeforeUnload; } // 2. If finalStatus is "canceled-by-beforeunload", then abort these steps. if (m_final_status == Result::CanceledByBeforeUnload) { finish(m_final_status); return; } // 3. Let navigation be traversable's active window's navigation API. VERIFY(m_traversable->active_window()); auto navigation = m_traversable->active_window()->navigation(); // 4. Let navigateEventResult be the result of firing a traverse navigate event at navigation given targetEntry and userInvolvementForNavigateEvent. VERIFY(m_target_entry); auto navigate_event_result = navigation->fire_a_traverse_navigate_event(*m_target_entry, *m_user_involvement); // 5. If navigateEventResult is false, then set finalStatus to "canceled-by-navigate". if (!navigate_event_result) m_final_status = Result::CanceledByNavigate; // 6. Set eventsFired to true. phase1_completed(); })); } void phase1_completed() { // 5. Wait for eventsFired to be true. // 6. If finalStatus is not "continue", then return finalStatus. if (m_final_status != Result::Continue) { finish(m_final_status); return; } start_phase2(); } void start_phase2() { if (m_phase2_documents.is_empty()) { finish(m_final_status); return; } // 5. Let totalTasks be the size of documentsToFireBeforeunload. // 6. Let completedTasks be 0. m_remaining_phase2_tasks = m_phase2_documents.size(); // 7. For each document of documentsToFireBeforeunload, queue a global task on the navigation and traversal task source given document's relevant global object to run the steps: for (auto& document : m_phase2_documents) { // AD-HOC: Queue with a null document instead of using queue_global_task. Tasks associated with a document // are only runnable when fully active. In the async state machine, documents can become non // fully-active between queue and execution time, causing the task to be permanently stuck. // A null-document task is always runnable; we check validity inside. queue_a_task(Task::Source::NavigationAndTraversal, nullptr, nullptr, GC::create_function(heap(), [this, document] { if (document->has_been_destroyed() || !document->is_fully_active()) { did_complete_phase2_task(); return; } // 1. Let (unloadPromptShownForThisDocument, unloadPromptCanceledByThisDocument) be the result of running the steps to fire beforeunload given document and unloadPromptShown. auto [unload_prompt_shown_for_this_document, unload_prompt_canceled_by_this_document] = document->steps_to_fire_beforeunload(m_unload_prompt_shown); // 2. If unloadPromptShownForThisDocument is true, then set unloadPromptShown to true. if (unload_prompt_shown_for_this_document) m_unload_prompt_shown = true; // 3. If unloadPromptCanceledByThisDocument is true, then set finalStatus to "canceled-by-beforeunload". if (unload_prompt_canceled_by_this_document) m_final_status = Result::CanceledByBeforeUnload; // 4. Increment completedTasks. did_complete_phase2_task(); })); } } void did_complete_phase2_task() { VERIFY(m_remaining_phase2_tasks > 0); if (--m_remaining_phase2_tasks > 0) return; // 8. Wait for completedTasks to be totalTasks. // 9. Return finalStatus. finish(m_final_status); } void finish(Result final_result) { if (m_completed) return; m_completed = true; m_timeout->stop(); m_callback->function()(final_result); } Result m_final_status { Result::Continue }; bool m_unload_prompt_shown { false }; bool m_completed { false }; bool m_needs_beforeunload { false }; size_t m_remaining_phase2_tasks { 0 }; Vector> m_phase2_documents; GC::Ptr m_traversable; RefPtr m_target_entry; Optional m_user_involvement; GC::Ref> m_callback; GC::Ref m_timeout; }; GC_DEFINE_ALLOCATOR(CheckUnloadingCanceledState); // https://html.spec.whatwg.org/multipage/browsing-the-web.html#checking-if-unloading-is-canceled void TraversableNavigable::check_if_unloading_is_canceled( Vector> navigables_that_need_before_unload, GC::Ptr traversable, Optional target_step, Optional user_involvement_for_navigate_events, GC::Ref> callback) { auto state = heap().allocate( traversable, user_involvement_for_navigate_events, callback); state->start(navigables_that_need_before_unload, target_step); } void TraversableNavigable::check_if_unloading_is_canceled(Vector> navigables_that_need_before_unload, GC::Ref> callback) { check_if_unloading_is_canceled(move(navigables_that_need_before_unload), {}, {}, {}, callback); } Vector> TraversableNavigable::get_session_history_entries_for_the_navigation_api(GC::Ref navigable, int target_step) { // 1. Let rawEntries be the result of getting session history entries for navigable. auto raw_entries = navigable->get_session_history_entries(); if (raw_entries.is_empty()) return {}; // 2. Let entriesForNavigationAPI be a new empty list. Vector> entries_for_navigation_api; // 3. Let startingIndex be the index of the session history entry in rawEntries who has the greatest step less than or equal to targetStep. // FIXME: Use min/max_element algorithm or some such here int starting_index = 0; Optional max_step; Optional maybe_starting_index; for (auto i = 0u; i < raw_entries.size(); ++i) { auto const& entry = raw_entries[i]; if (auto step = entry->step_value(); step.has_value()) { if (*step <= target_step && (!max_step.has_value() || *step > *max_step)) { starting_index = static_cast(i); maybe_starting_index = starting_index; max_step = *step; } } } if (!maybe_starting_index.has_value()) return {}; // 4. Append rawEntries[startingIndex] to entriesForNavigationAPI. entries_for_navigation_api.append(raw_entries[starting_index]); // 5. Let startingOrigin be rawEntries[startingIndex]'s document state's origin. auto starting_origin = raw_entries[starting_index]->document_state()->origin(); // 6. Let i be startingIndex − 1. auto i = starting_index - 1; // 7. While i > 0: while (i > 0) { auto& entry = raw_entries[static_cast(i)]; if (!entry->step_value().has_value()) { --i; continue; } // 1. If rawEntries[i]'s document state's origin is not same origin with startingOrigin, then break. auto entry_origin = entry->document_state()->origin(); if (starting_origin.has_value() && entry_origin.has_value() && !entry_origin->is_same_origin(*starting_origin)) break; // 2. Prepend rawEntries[i] to entriesForNavigationAPI. entries_for_navigation_api.prepend(entry); // 3. Set i to i − 1. --i; } // 8. Set i to startingIndex + 1. i = starting_index + 1; // 9. While i < rawEntries's size: while (i < static_cast(raw_entries.size())) { auto& entry = raw_entries[static_cast(i)]; if (!entry->step_value().has_value()) { ++i; continue; } // 1. If rawEntries[i]'s document state's origin is not same origin with startingOrigin, then break. auto entry_origin = entry->document_state()->origin(); if (starting_origin.has_value() && entry_origin.has_value() && !entry_origin->is_same_origin(*starting_origin)) break; // 2. Append rawEntries[i] to entriesForNavigationAPI. entries_for_navigation_api.append(entry); // 3. Set i to i + 1. ++i; } // 10. Return entriesForNavigationAPI. return entries_for_navigation_api; } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#clear-the-forward-session-history void TraversableNavigable::clear_the_forward_session_history() { // FIXME: 1. Assert: this is running within navigable's session history traversal queue. // 2. Let step be the navigable's current session history step. auto step = current_session_history_step(); // 3. Let entryLists be the ordered set « navigable's session history entries ». Vector>&> entry_lists; entry_lists.append(session_history_entries()); // 4. For each entryList of entryLists: while (!entry_lists.is_empty()) { auto& entry_list = entry_lists.take_first(); // 1. Remove every session history entry from entryList that has a step greater than step. entry_list.remove_all_matching([step](auto& entry) { auto entry_step = entry->step_value(); return entry_step.has_value() && *entry_step > step; }); // 2. For each entry of entryList: for (auto& entry : entry_list) { // NB: "pending" is not a used history step, so its nested histories // are not part of the traversable's used step graph yet. if (!entry->step_value().has_value()) continue; // 1. For each nestedHistory of entry's document state's nested histories, append nestedHistory's entries list to entryLists. for (auto& nested_history : entry->document_state()->nested_histories()) { entry_lists.append(nested_history.entries); } } } } bool TraversableNavigable::can_go_back() const { auto all_steps = get_all_used_history_steps(); auto current_step_index = all_steps.find_first_index(current_session_history_step()); VERIFY(current_step_index.has_value()); return *current_step_index > 0; } bool TraversableNavigable::can_go_forward() const { auto all_steps = get_all_used_history_steps(); auto current_step_index = all_steps.find_first_index(current_session_history_step()); VERIFY(current_step_index.has_value()); return *current_step_index + 1 < all_steps.size(); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#traverse-the-history-by-a-delta void TraversableNavigable::traverse_the_history_by_delta(int delta, GC::Ptr source_document) { // 1. Let sourceSnapshotParams and initiatorToCheck be null. GC::Ptr source_snapshot_params = nullptr; GC::Ptr initiator_to_check = nullptr; // 2. Let userInvolvement be "browser UI". UserNavigationInvolvement user_involvement = UserNavigationInvolvement::BrowserUI; // 3. If sourceDocument is given, then: if (source_document) { // 1. Set sourceSnapshotParams to the result of snapshotting source snapshot params given sourceDocument. source_snapshot_params = source_document->snapshot_source_snapshot_params(); // 2. Set initiatorToCheck to sourceDocument's node navigable. initiator_to_check = source_document->navigable(); // 3. Set userInvolvement to "none". user_involvement = UserNavigationInvolvement::None; } // 4. Append the following session history traversal steps to traversable: append_session_history_traversal_steps(GC::create_function(heap(), [this, delta, source_snapshot_params, initiator_to_check, user_involvement](NonnullRefPtr> signal) { // 1. Let allSteps be the result of getting all used history steps for traversable. auto all_steps = get_all_used_history_steps(); // 2. Let currentStepIndex be the index of traversable's current session history step within allSteps. auto current_step_index = *all_steps.find_first_index(current_session_history_step()); // 3. Let targetStepIndex be currentStepIndex plus delta size_t target_step_index = 0; if (delta < 0) { auto magnitude = static_cast(-static_cast(delta)); if (magnitude > current_step_index) { if (source_snapshot_params && page().client().page_did_request_traverse_the_history_by_delta(delta, HistoryTraversalPrecheck::Needed)) { signal->resolve({}); return; } signal->resolve({}); return; } target_step_index = current_step_index - magnitude; } else { auto magnitude = static_cast(delta); if (magnitude >= all_steps.size() - current_step_index) { if (source_snapshot_params && page().client().page_did_request_traverse_the_history_by_delta(delta, HistoryTraversalPrecheck::Needed)) { signal->resolve({}); return; } signal->resolve({}); return; } target_step_index = current_step_index + magnitude; } // 4. If allSteps[targetStepIndex] does not exist, then abort these steps. if (target_step_index >= all_steps.size()) { if (source_snapshot_params && page().client().page_did_request_traverse_the_history_by_delta(delta, HistoryTraversalPrecheck::Needed)) { signal->resolve({}); return; } signal->resolve({}); return; } auto target_step = all_steps[target_step_index]; if (source_snapshot_params) { RefPtr target_top_level_entry; for (auto const& entry : session_history_entries()) { auto entry_step = entry->step_value(); if (!entry_step.has_value()) continue; if (*entry_step > target_step) break; target_top_level_entry = entry; } if (target_top_level_entry && current_session_history_entry() && !page().client().is_url_suitable_for_same_process_navigation(current_session_history_entry()->url(), target_top_level_entry->url())) { run_the_history_step_prechecks(target_step, true, source_snapshot_params, initiator_to_check, user_involvement, Bindings::NavigationType::Traverse, Navigable::NavigationAPIAbortBehavior::Abort, GC::create_function(heap(), [this, delta, signal](HistoryStepResult result, int, Navigable::NavigationAPIAbortBehavior) { if (result == HistoryStepResult::Applied) (void)page().client().page_did_request_traverse_the_history_by_delta(delta, HistoryTraversalPrecheck::AlreadyDone); signal->resolve({}); })); return; } } // 5. Apply the traverse history step allSteps[targetStepIndex] to traversable, given sourceSnapshotParams, // initiatorToCheck, and userInvolvement. apply_the_traverse_history_step(target_step, source_snapshot_params, initiator_to_check, user_involvement, GC::create_function(heap(), [signal](HistoryStepResult) { signal->resolve({}); })); })); } void TraversableNavigable::traverse_the_history_to_step(int step, GC::Ref> on_complete) { // NB: This is used when the UI process owns the top-level session // history and has already resolved the browser UI delta to a stable step. append_session_history_traversal_steps(GC::create_function(heap(), [this, step, on_complete](NonnullRefPtr> signal) { auto all_steps = get_all_used_history_steps(); if (!all_steps.contains_slow(step)) { on_complete->function()(false, HistoryStepResult::Applied); signal->resolve({}); return; } apply_the_traverse_history_step(step, nullptr, nullptr, UserNavigationInvolvement::BrowserUI, GC::create_function(heap(), [signal, on_complete](HistoryStepResult result) { on_complete->function()(true, result); signal->resolve({}); })); })); } void TraversableNavigable::check_if_traverse_history_step_is_canceled(int step, GC::Ref on_complete) { // NB: This is used when the UI process owns the top-level session history // and needs WebContent to run the cancelable part of the traverse algorithm // before the UI process applies its own history mirror update. append_session_history_traversal_steps(GC::create_function(heap(), [this, step, on_complete](NonnullRefPtr> signal) { auto all_steps = get_all_used_history_steps(); if (!all_steps.contains_slow(step)) { // NB: The UI process can ask about a step in its authoritative session history mirror that this WebContent // process cannot address locally, for example after a process swap with a partial restored history. We // cannot run the full traverse prechecks without the target entry, but the active document tree still // must get a chance to cancel unloading before the UI process replaces this WebContent process or // fallback-loads the target entry. check_if_unloading_is_canceled(active_document()->inclusive_descendant_navigables(), GC::create_function(heap(), [signal, on_complete](CheckIfUnloadingIsCanceledResult result) { on_complete->function()(result == CheckIfUnloadingIsCanceledResult::Continue ? HistoryStepResult::Applied : HistoryStepResult::CanceledByBeforeUnload); signal->resolve({}); })); return; } run_the_history_step_prechecks(step, true, nullptr, nullptr, UserNavigationInvolvement::BrowserUI, Bindings::NavigationType::Traverse, Navigable::NavigationAPIAbortBehavior::Abort, GC::create_function(heap(), [signal, on_complete](HistoryStepResult result, int, Navigable::NavigationAPIAbortBehavior) { on_complete->function()(result); signal->resolve({}); })); })); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#update-for-navigable-creation/destruction void TraversableNavigable::update_for_navigable_creation_or_destruction(GC::Ref on_complete) { // 1. Let step be traversable's current session history step. auto step = current_session_history_step(); // 2. Return the result of applying the history step to traversable given false, null, null, null, and null. apply_the_history_step(step, false, {}, {}, UserNavigationInvolvement::None, {}, SynchronousNavigation::No, Navigable::NavigationAPIAbortBehavior::Abort, nullptr, nullptr, {}, on_complete); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#apply-the-reload-history-step void TraversableNavigable::apply_the_reload_history_step(UserNavigationInvolvement user_involvement, GC::Ref> on_complete) { // 1. Let step be traversable's current session history step. auto step = current_session_history_step(); // 2. Return the result of applying the history step step to traversable given true, null, null, null, and "reload". apply_the_history_step(step, true, {}, {}, user_involvement, Bindings::NavigationType::Reload, SynchronousNavigation::No, Navigable::NavigationAPIAbortBehavior::Abort, nullptr, nullptr, {}, GC::create_function(heap(), [this, on_complete](HistoryStepResult result) { if (result != HistoryStepResult::Applied) { // NB: A canceled reload must not keep treating the active // session history entry as an in-flight reload. if (auto current_entry = current_session_history_entry(); current_entry && current_entry->document_state()->reload_pending()) { current_entry->document_state()->set_reload_pending(false); if (page().client().should_report_session_history_updates()) { auto session_history_snapshot = create_session_history_snapshot(); page().client().page_did_update_session_history(session_history_snapshot.top_level_session_history_entries, session_history_snapshot.used_session_history_steps, session_history_snapshot.current_used_step_index); } } } on_complete->function()(result); })); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#apply-the-push/replace-history-step void TraversableNavigable::apply_the_push_or_replace_history_step(int step, HistoryHandlingBehavior history_handling, UserNavigationInvolvement user_involvement, SynchronousNavigation synchronous_navigation, GC::Ptr pending_document, GC::Ptr expected_ongoing_navigation_navigable, Optional expected_ongoing_navigation_id, GC::Ref on_complete) { // 1. Return the result of applying the history step step to traversable given false, null, null, userInvolvement, and historyHandling. auto navigation_type = history_handling == HistoryHandlingBehavior::Replace ? Bindings::NavigationType::Replace : Bindings::NavigationType::Push; apply_the_history_step(step, false, {}, {}, user_involvement, navigation_type, synchronous_navigation, Navigable::NavigationAPIAbortBehavior::Abort, pending_document, expected_ongoing_navigation_navigable, move(expected_ongoing_navigation_id), on_complete); } static Optional update_session_history_entries_for_same_document_navigation(TraversableNavigable& traversable, GC::Ref target_navigable, NonnullRefPtr target_entry, RefPtr entry_to_replace) { // NB: This is the entry-list portion of the "finalize a same-document navigation" algorithm. Keep the synchronous // commit path and the queued fallback sharing it so the two paths cannot drift. // 2. If targetNavigable's active session history entry is not targetEntry, then return. // FIXME: This is a workaround for a spec issue where the early return loses replace entries. // Revisit when https://github.com/whatwg/html/issues/10232 is resolved. if (target_navigable->active_session_history_entry() != target_entry) { if (entry_to_replace) { auto& target_entries = target_navigable->get_session_history_entries(); if (auto it = target_entries.find(*entry_to_replace); it != target_entries.end()) { target_entry->set_step(entry_to_replace->step()); *it = target_entry; } } return {}; } // 3. Let targetStep be null. Optional target_step; // 4. Let targetEntries be the result of getting session history entries for targetNavigable. auto& target_entries = target_navigable->get_session_history_entries(); // 5. If entryToReplace is null, then: // FIXME: Checking containment of entryToReplace should not be needed. // For more details see https://github.com/whatwg/html/issues/10232#issuecomment-2037543137 if (!entry_to_replace || !target_entries.contains_slow(NonnullRefPtr { *entry_to_replace })) { // 1. Clear the forward session history of traversable. traversable.clear_the_forward_session_history(); // 2. Set targetStep to traversable's current session history step + 1. target_step = traversable.current_session_history_step() + 1; // 3. Set targetEntry's step to targetStep. target_entry->set_step(*target_step); // 4. Append targetEntry to targetEntries. target_entries.append(target_entry); } else { // 1. Replace entryToReplace with targetEntry in targetEntries. *(target_entries.find(*entry_to_replace)) = target_entry; // 2. Set targetEntry's step to entryToReplace's step. target_entry->set_step(entry_to_replace->step()); // 3. Set targetStep to traversable's current session history step. target_step = traversable.current_session_history_step(); } return target_step; } bool TraversableNavigable::try_to_synchronously_commit_same_document_navigation(GC::Ref target_navigable, NonnullRefPtr target_entry, RefPtr entry_to_replace) { if (m_apply_history_step_state || m_paused_apply_history_step_state) return false; if (target_navigable->has_been_destroyed()) return true; if (!target_navigable->has_session_history_entry_and_ready_for_navigation()) return false; // https://html.spec.whatwg.org/multipage/browsing-the-web.html#finalize-a-same-document-navigation auto target_step = update_session_history_entries_for_same_document_navigation(*this, target_navigable, target_entry, entry_to_replace); if (!target_step.has_value()) return true; target_navigable->set_current_session_history_entry(target_entry); m_current_session_history_step = get_the_used_step(*target_step); // NB: The queued apply-history-step path clears the ongoing navigation when the history step finishes. The // synchronous fast path has already committed the same-document navigation and the Navigation API entry update // owns settling its promises/events, so do the same cleanup without reporting an abort to the Navigation API. if (!synchronous_same_document_navigation_must_preserve_ongoing_navigation(*target_navigable)) target_navigable->set_ongoing_navigation({}, Navigable::NavigationAPIAbortBehavior::Preserve); auto history_object_length_and_index = get_the_history_object_length_and_index(m_current_session_history_step); if (auto active_document = this->active_document()) { for (auto const& navigable : active_document->inclusive_descendant_navigables()) { if (navigable->has_been_destroyed() || !navigable->active_window() || !navigable->active_document()->is_fully_active()) continue; auto document = navigable->active_document(); document->history()->m_index = history_object_length_and_index.script_history_index; document->history()->m_length = history_object_length_and_index.script_history_length; } } if (page().client().should_report_session_history_updates()) { auto session_history_snapshot = create_session_history_snapshot(SaveActiveEntryPersistedState::Yes); page().client().page_did_update_session_history(session_history_snapshot.top_level_session_history_entries, session_history_snapshot.used_session_history_steps, session_history_snapshot.current_used_step_index); } VERIFY(session_history_entries().size() > 0); page().client().page_did_update_navigation_buttons_state(can_go_back(), can_go_forward()); page().client().page_did_change_url(current_session_history_entry()->url()); return true; } void TraversableNavigable::apply_the_traverse_history_step(int step, GC::Ptr source_snapshot_params, GC::Ptr initiator_to_check, UserNavigationInvolvement user_involvement, GC::Ref> on_complete) { // 1. Return the result of applying the history step step to traversable given true, sourceSnapshotParams, initiatorToCheck, userInvolvement, and "traverse". apply_the_history_step(step, true, source_snapshot_params, initiator_to_check, user_involvement, Bindings::NavigationType::Traverse, SynchronousNavigation::No, Navigable::NavigationAPIAbortBehavior::Abort, nullptr, nullptr, {}, on_complete); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#resume-applying-the-traverse-history-step void TraversableNavigable::resume_applying_the_traverse_history_step(int step, UserNavigationInvolvement user_involvement, GC::Ref> on_complete) { // To resume applying the traverse history step given a non-negative integer step, a traversable // navigable traversable, and user navigation involvement userInvolvement, apply step to // traversable given false, null, null, userInvolvement, and "traverse". // NOTE: When resuming a traverse, we are already past the cancelation, initiator, and // source snapshot checks, and this traversal has already been determined to be a // same-document traversal. Hence, we can pass false and null for those arguments. // NB: The committed navigate event remains ongoing until the same-document entry update runs // the navigate event intercept commit handler steps. apply_the_history_step(step, false, {}, {}, user_involvement, Bindings::NavigationType::Traverse, SynchronousNavigation::No, Navigable::NavigationAPIAbortBehavior::Preserve, nullptr, nullptr, {}, on_complete); } // https://html.spec.whatwg.org/multipage/document-sequences.html#close-a-top-level-traversable void TraversableNavigable::close_top_level_traversable() { // 1. If traversable's is closing is true, then return. if (is_closing()) return; // AD-HOC: Set the is closing flag to prevent re-entrant calls from queuing duplicate session history steps. set_closing(true); // 2. Definitely close traversable. definitely_close_top_level_traversable(); } // https://html.spec.whatwg.org/multipage/document-sequences.html#definitely-close-a-top-level-traversable void TraversableNavigable::definitely_close_top_level_traversable() { VERIFY(is_top_level_traversable()); // 1. Let toUnload be traversable's active document's inclusive descendant navigables. auto to_unload = active_document()->inclusive_descendant_navigables(); // 2. If the result of checking if unloading is canceled for toUnload is not "continue", then return. check_if_unloading_is_canceled(move(to_unload), GC::create_function(heap(), [this](CheckIfUnloadingIsCanceledResult result) { if (result != CheckIfUnloadingIsCanceledResult::Continue) return; // 3. Append the following session history traversal steps to traversable: append_session_history_traversal_steps(GC::create_function(heap(), [this](NonnullRefPtr> signal) { // 1. Let afterAllUnloads be an algorithm step which destroys traversable. auto after_all_unloads = GC::create_function(heap(), [this] { destroy_top_level_traversable(); }); // 2. Unload a document and its descendants given traversable's active document, null, and afterAllUnloads. active_document()->unload_a_document_and_its_descendants({}, after_all_unloads); signal->resolve({}); })); })); } // https://html.spec.whatwg.org/multipage/document-sequences.html#destroy-a-top-level-traversable void TraversableNavigable::destroy_top_level_traversable() { VERIFY(is_top_level_traversable()); // 1. Let browsingContext be traversable's active browsing context. auto browsing_context = active_browsing_context(); // 2. For each historyEntry in traversable's session history entries: // NOTE: Without bfcache, only the active document is alive, so we only need to destroy it. if (active_document()) active_document()->destroy_a_document_and_its_descendants(); // 3. Remove browsingContext. if (!browsing_context) { dbgln("TraversableNavigable::destroy_top_level_traversable: No browsing context?"); } else { browsing_context->remove(); } // 4. Remove traversable from the user interface (e.g., close or hide its tab in a tabbed browser). page().client().page_did_close_top_level_traversable(); // 5. Remove traversable from the user agent's top-level traversable set. user_agent_top_level_traversable_set().remove(this); // FIXME: 6. Invoke WebDriver BiDi navigable destroyed with traversable. // FIXME: Figure out why we need to do this... we shouldn't be leaking Navigables for all time. // However, without this, we can keep stale destroyed traversables around. set_has_been_destroyed(); remove_from_all_navigables(); } // https://html.spec.whatwg.org/multipage/browsing-the-web.html#finalize-a-same-document-navigation void finalize_a_same_document_navigation(GC::Ref traversable, GC::Ref target_navigable, NonnullRefPtr target_entry, RefPtr entry_to_replace, HistoryHandlingBehavior history_handling, UserNavigationInvolvement user_involvement, GC::Ref on_complete) { // NOTE: This is not in the spec but we should not navigate destroyed navigable. if (target_navigable->has_been_destroyed()) { on_complete->function()(HistoryStepResult::Applied); return; } // FIXME: 1. Assert: this is running on traversable's session history traversal queue. auto target_step = update_session_history_entries_for_same_document_navigation(*traversable, target_navigable, target_entry, entry_to_replace); if (!target_step.has_value()) { on_complete->function()(HistoryStepResult::Applied); return; } // 6. Apply the push/replace history step targetStep to traversable given historyHandling and userInvolvement. traversable->apply_the_push_or_replace_history_step(*target_step, history_handling, user_involvement, TraversableNavigable::SynchronousNavigation::Yes, nullptr, nullptr, {}, on_complete); } // https://html.spec.whatwg.org/multipage/interaction.html#system-visibility-state void TraversableNavigable::set_system_visibility_state(VisibilityState visibility_state) { if (m_system_visibility_state == visibility_state) return; m_system_visibility_state = visibility_state; // When a user agent determines that the system visibility state for // traversable navigable traversable has changed to newState, it must run the following steps: // 1. Let navigables be the inclusive descendant navigables of traversable's active document. auto navigables = active_document()->inclusive_descendant_navigables(); // 2. For each navigable of navigables: for (auto& navigable : navigables) { // 1. Let document be navigable's active document. auto document = navigable->active_document(); VERIFY(document); // 2. Queue a global task on the user interaction task source given document's relevant global object // to update the visibility state of document with newState. queue_global_task(Task::Source::UserInteraction, relevant_global_object(*document), GC::create_function(heap(), [visibility_state, document] { document->update_the_visibility_state(visibility_state); })); } } // https://html.spec.whatwg.org/multipage/interaction.html#currently-focused-area-of-a-top-level-traversable GC::Ptr TraversableNavigable::currently_focused_area() { // 1. If traversable does not have system focus, then return null. if (!is_focused()) return nullptr; // 2. Let candidate be traversable's active document. auto candidate = active_document(); // 3. While candidate's focused area is a navigable container with a non-null content navigable: // set candidate to the active document of that navigable container's content navigable. while (candidate->focused_area() && is(candidate->focused_area().ptr()) && as(*candidate->focused_area()).content_navigable()) { candidate = as(*candidate->focused_area()).content_navigable()->active_document(); } // 4. If candidate's focused area is non-null, set candidate to candidate's focused area. if (candidate->focused_area()) { // NOTE: We return right away here instead of assigning to candidate, // since that would require compromising type safety. return candidate->focused_area(); } // 5. Return candidate. return candidate; } // https://w3c.github.io/geolocation/#dfn-emulated-position-data Geolocation::EmulatedPositionData const& TraversableNavigable::emulated_position_data() const { VERIFY(is_top_level_traversable()); return m_emulated_position_data; } // https://w3c.github.io/geolocation/#dfn-emulated-position-data void TraversableNavigable::set_emulated_position_data(Geolocation::EmulatedPositionData data) { VERIFY(is_top_level_traversable()); m_emulated_position_data = data; } void TraversableNavigable::process_screenshot_requests() { auto& client = page().client(); while (!m_screenshot_tasks.is_empty()) { auto task = m_screenshot_tasks.dequeue(); if (task.node_id.has_value()) { auto* dom_node = DOM::Node::from_unique_id(*task.node_id); if (dom_node) dom_node->document().update_layout(DOM::UpdateLayoutReason::ProcessScreenshot); if (!dom_node || !dom_node->paintable_box()) { client.page_did_take_screenshot({}); continue; } auto rect = page().enclosing_device_rect(dom_node->paintable_box()->absolute_border_box_rect()); auto bitmap_or_error = Gfx::Bitmap::create(Gfx::BitmapFormat::BGRA8888, rect.size().to_type()); if (bitmap_or_error.is_error()) { client.page_did_take_screenshot({}); continue; } auto bitmap = bitmap_or_error.release_value(); auto painting_surface = Gfx::PaintingSurface::wrap_bitmap(*bitmap); PaintConfig paint_config { .canvas_fill_rect = rect.to_type() }; render_screenshot(painting_surface, paint_config, [bitmap, &client] { client.page_did_take_screenshot(bitmap->to_shareable_bitmap()); }); } else { active_document()->update_layout(DOM::UpdateLayoutReason::ProcessScreenshot); auto scrollable_overflow_rect = active_document()->layout_node()->paintable_box()->scrollable_overflow_rect(); auto rect = page().enclosing_device_rect(scrollable_overflow_rect.value()); auto bitmap_or_error = Gfx::Bitmap::create(Gfx::BitmapFormat::BGRA8888, rect.size().to_type()); if (bitmap_or_error.is_error()) { client.page_did_take_screenshot({}); continue; } auto bitmap = bitmap_or_error.release_value(); auto painting_surface = Gfx::PaintingSurface::wrap_bitmap(*bitmap); PaintConfig paint_config { .paint_overlay = true, .canvas_fill_rect = rect.to_type() }; render_screenshot(painting_surface, paint_config, [bitmap, &client] { client.page_did_take_screenshot(bitmap->to_shareable_bitmap()); }); } } } }