BrowsingContext.cpp 37 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917
  1. /*
  2. * Copyright (c) 2018-2022, Andreas Kling <kling@serenityos.org>
  3. *
  4. * SPDX-License-Identifier: BSD-2-Clause
  5. */
  6. #include <LibWeb/Bindings/MainThreadVM.h>
  7. #include <LibWeb/DOM/Document.h>
  8. #include <LibWeb/DOM/ElementFactory.h>
  9. #include <LibWeb/DOM/Event.h>
  10. #include <LibWeb/DOM/HTMLCollection.h>
  11. #include <LibWeb/DOM/Range.h>
  12. #include <LibWeb/Fetch/Infrastructure/HTTP/Requests.h>
  13. #include <LibWeb/HTML/BrowsingContext.h>
  14. #include <LibWeb/HTML/BrowsingContextGroup.h>
  15. #include <LibWeb/HTML/CrossOrigin/CrossOriginOpenerPolicy.h>
  16. #include <LibWeb/HTML/DocumentState.h>
  17. #include <LibWeb/HTML/EventLoop/EventLoop.h>
  18. #include <LibWeb/HTML/HTMLAnchorElement.h>
  19. #include <LibWeb/HTML/HTMLDocument.h>
  20. #include <LibWeb/HTML/HTMLInputElement.h>
  21. #include <LibWeb/HTML/NavigableContainer.h>
  22. #include <LibWeb/HTML/RemoteBrowsingContext.h>
  23. #include <LibWeb/HTML/SandboxingFlagSet.h>
  24. #include <LibWeb/HTML/Scripting/WindowEnvironmentSettingsObject.h>
  25. #include <LibWeb/HTML/TraversableNavigable.h>
  26. #include <LibWeb/HTML/Window.h>
  27. #include <LibWeb/HTML/WindowProxy.h>
  28. #include <LibWeb/HighResolutionTime/TimeOrigin.h>
  29. #include <LibWeb/Infra/Strings.h>
  30. #include <LibWeb/Layout/BreakNode.h>
  31. #include <LibWeb/Layout/TextNode.h>
  32. #include <LibWeb/Layout/Viewport.h>
  33. #include <LibWeb/Namespace.h>
  34. #include <LibWeb/Page/Page.h>
  35. #include <LibWeb/URL/URL.h>
  36. namespace Web::HTML {
  37. // https://html.spec.whatwg.org/multipage/urls-and-fetching.html#matches-about:blank
  38. bool url_matches_about_blank(AK::URL const& url)
  39. {
  40. // A URL matches about:blank if its scheme is "about", its path contains a single string "blank", its username and password are the empty string, and its host is null.
  41. return url.scheme() == "about"sv
  42. && url.serialize_path() == "blank"sv
  43. && url.raw_username().is_empty()
  44. && url.raw_password().is_empty()
  45. && url.host().has<Empty>();
  46. }
  47. // https://html.spec.whatwg.org/multipage/document-sequences.html#determining-the-origin
  48. HTML::Origin determine_the_origin(AK::URL const& url, SandboxingFlagSet sandbox_flags, Optional<HTML::Origin> source_origin, Optional<HTML::Origin> container_origin)
  49. {
  50. // 1. If sandboxFlags has its sandboxed origin browsing context flag set, then return a new opaque origin.
  51. if (has_flag(sandbox_flags, SandboxingFlagSet::SandboxedOrigin)) {
  52. return HTML::Origin {};
  53. }
  54. // FIXME: 2. If url is null, then return a new opaque origin.
  55. // FIXME: There appears to be no way to get a null URL here, so it might be a spec bug.
  56. // 3. If url is about:srcdoc, then:
  57. if (url == "about:srcdoc"sv) {
  58. // 1. Assert: containerOrigin is non-null.
  59. VERIFY(container_origin.has_value());
  60. // 2. Return containerOrigin.
  61. return container_origin.release_value();
  62. }
  63. // 4. If url matches about:blank and sourceOrigin is non-null, then return sourceOrigin.
  64. if (url_matches_about_blank(url) && source_origin.has_value())
  65. return source_origin.release_value();
  66. // 5. Return url's origin.
  67. return URL::url_origin(url);
  68. }
  69. // https://html.spec.whatwg.org/multipage/document-sequences.html#creating-a-new-auxiliary-browsing-context
  70. WebIDL::ExceptionOr<BrowsingContext::BrowsingContextAndDocument> BrowsingContext::create_a_new_auxiliary_browsing_context_and_document(Page& page, JS::NonnullGCPtr<HTML::BrowsingContext> opener)
  71. {
  72. // 1. Let openerTopLevelBrowsingContext be opener's top-level traversable's active browsing context.
  73. auto opener_top_level_browsing_context = opener->top_level_traversable()->active_browsing_context();
  74. // 2. Let group be openerTopLevelBrowsingContext's group.
  75. auto group = opener_top_level_browsing_context->group();
  76. // 3. Assert: group is non-null, as navigating invokes this directly.
  77. VERIFY(group);
  78. // 4. Set browsingContext and document be the result of creating a new browsing context and document with opener's active document, null, and group.
  79. auto [browsing_context, document] = TRY(create_a_new_browsing_context_and_document(page, opener->active_document(), nullptr, *group));
  80. // FIXME: 5. Set browsingContext's is auxiliary to true.
  81. // 6. Append browsingContext to group.
  82. group->append(browsing_context);
  83. // 7. Set browsingContext's opener browsing context to opener.
  84. browsing_context->set_opener_browsing_context(opener);
  85. // FIXME: 8. Set browsingContext's virtual browsing context group ID to openerTopLevelBrowsingContext's virtual browsing context group ID.
  86. // FIXME: 9. Set browsingContext's opener origin at creation to opener's active document's origin.
  87. // 10. Return browsingContext and document.
  88. return BrowsingContext::BrowsingContextAndDocument { browsing_context, document };
  89. }
  90. // https://html.spec.whatwg.org/multipage/document-sequences.html#creating-a-new-browsing-context
  91. WebIDL::ExceptionOr<BrowsingContext::BrowsingContextAndDocument> BrowsingContext::create_a_new_browsing_context_and_document(Page& page, JS::GCPtr<DOM::Document> creator, JS::GCPtr<DOM::Element> embedder, JS::NonnullGCPtr<BrowsingContextGroup> group)
  92. {
  93. auto& vm = group->vm();
  94. // 1. Let browsingContext be a new browsing context.
  95. JS::NonnullGCPtr<BrowsingContext> browsing_context = *vm.heap().allocate_without_realm<BrowsingContext>(page, nullptr);
  96. // 2. Let unsafeContextCreationTime be the unsafe shared current time.
  97. [[maybe_unused]] auto unsafe_context_creation_time = HighResolutionTime::unsafe_shared_current_time();
  98. // 3. Let creatorOrigin be null.
  99. Optional<Origin> creator_origin = {};
  100. // 4. If creator is non-null, then:
  101. if (creator) {
  102. // 1. Set creatorOrigin to creator's origin.
  103. creator_origin = creator->origin();
  104. // FIXME: 2. Set browsingContext's creator base URL to an algorithm which returns creator's base URL.
  105. // FIXME: 3. Set browsingContext's virtual browsing context group ID to creator's browsing context's top-level browsing context's virtual browsing context group ID.
  106. }
  107. // FIXME: 5. Let sandboxFlags be the result of determining the creation sandboxing flags given browsingContext and embedder.
  108. SandboxingFlagSet sandbox_flags = {};
  109. // 6. Let origin be the result of determining the origin given about:blank, sandboxFlags, creatorOrigin, and null.
  110. auto origin = determine_the_origin(AK::URL("about:blank"sv), sandbox_flags, creator_origin, {});
  111. // FIXME: 7. Let permissionsPolicy be the result of creating a permissions policy given browsingContext and origin. [PERMISSIONSPOLICY]
  112. // FIXME: 8. Let agent be the result of obtaining a similar-origin window agent given origin, group, and false.
  113. JS::GCPtr<Window> window;
  114. // 9. Let realm execution context be the result of creating a new JavaScript realm given agent and the following customizations:
  115. auto realm_execution_context = Bindings::create_a_new_javascript_realm(
  116. Bindings::main_thread_vm(),
  117. [&](JS::Realm& realm) -> JS::Object* {
  118. auto window_proxy = realm.heap().allocate<WindowProxy>(realm, realm);
  119. browsing_context->set_window_proxy(window_proxy);
  120. // - For the global object, create a new Window object.
  121. window = Window::create(realm);
  122. return window.ptr();
  123. },
  124. [&](JS::Realm&) -> JS::Object* {
  125. // - For the global this binding, use browsingContext's WindowProxy object.
  126. return browsing_context->window_proxy();
  127. });
  128. // 10. Let topLevelCreationURL be about:blank if embedder is null; otherwise embedder's relevant settings object's top-level creation URL.
  129. auto top_level_creation_url = !embedder ? AK::URL("about:blank") : relevant_settings_object(*embedder).top_level_creation_url;
  130. // 11. Let topLevelOrigin be origin if embedder is null; otherwise embedder's relevant settings object's top-level origin.
  131. auto top_level_origin = !embedder ? origin : relevant_settings_object(*embedder).origin();
  132. // 12. Set up a window environment settings object with about:blank, realm execution context, null, topLevelCreationURL, and topLevelOrigin.
  133. WindowEnvironmentSettingsObject::setup(
  134. AK::URL("about:blank"),
  135. move(realm_execution_context),
  136. {},
  137. top_level_creation_url,
  138. top_level_origin);
  139. // 13. Let loadTimingInfo be a new document load timing info with its navigation start time set to the result of calling
  140. // coarsen time with unsafeContextCreationTime and the new environment settings object's cross-origin isolated capability.
  141. auto load_timing_info = DOM::DocumentLoadTimingInfo();
  142. load_timing_info.navigation_start_time = HighResolutionTime::coarsen_time(
  143. unsafe_context_creation_time,
  144. verify_cast<WindowEnvironmentSettingsObject>(Bindings::host_defined_environment_settings_object(window->realm())).cross_origin_isolated_capability() == CanUseCrossOriginIsolatedAPIs::Yes);
  145. // 14. Let document be a new Document, with:
  146. auto document = HTML::HTMLDocument::create(window->realm());
  147. // Non-standard
  148. window->set_associated_document(*document);
  149. // type: "html"
  150. document->set_document_type(DOM::Document::Type::HTML);
  151. // content type: "text/html"
  152. document->set_content_type("text/html"_string);
  153. // mode: "quirks"
  154. document->set_quirks_mode(DOM::QuirksMode::Yes);
  155. // origin: origin
  156. document->set_origin(origin);
  157. // browsing context: browsingContext
  158. document->set_browsing_context(browsing_context);
  159. // FIXME: permissions policy: permissionsPolicy
  160. // FIXME: active sandboxing flag set: sandboxFlags
  161. // load timing info: loadTimingInfo
  162. document->set_load_timing_info(load_timing_info);
  163. // is initial about:blank: true
  164. document->set_is_initial_about_blank(true);
  165. // 15. If creator is non-null, then:
  166. if (creator) {
  167. // 1. Set document's referrer to the serialization of creator's URL.
  168. document->set_referrer(creator->url().serialize());
  169. // FIXME: 2. Set document's policy container to a clone of creator's policy container.
  170. // 3. If creator's origin is same origin with creator's relevant settings object's top-level origin,
  171. if (creator->origin().is_same_origin(creator->relevant_settings_object().top_level_origin)) {
  172. // then set document's cross-origin opener policy to creator's browsing context's top-level browsing context's active document's cross-origin opener policy.
  173. VERIFY(creator->browsing_context());
  174. VERIFY(creator->browsing_context()->top_level_browsing_context()->active_document());
  175. document->set_cross_origin_opener_policy(creator->browsing_context()->top_level_browsing_context()->active_document()->cross_origin_opener_policy());
  176. }
  177. }
  178. // 16. Assert: document's URL and document's relevant settings object's creation URL are about:blank.
  179. VERIFY(document->url() == "about:blank"sv);
  180. VERIFY(document->relevant_settings_object().creation_url == "about:blank"sv);
  181. // 17. Mark document as ready for post-load tasks.
  182. document->set_ready_for_post_load_tasks(true);
  183. // 18. Ensure that document has a single child html node, which itself has two empty child nodes: a head element, and a body element.
  184. auto html_node = TRY(DOM::create_element(document, HTML::TagNames::html, Namespace::HTML));
  185. auto head_element = TRY(DOM::create_element(document, HTML::TagNames::head, Namespace::HTML));
  186. TRY(html_node->append_child(head_element));
  187. auto body_element = TRY(DOM::create_element(document, HTML::TagNames::body, Namespace::HTML));
  188. TRY(html_node->append_child(body_element));
  189. TRY(document->append_child(html_node));
  190. // 19. Make active document.
  191. document->make_active();
  192. // 20. Completely finish loading document.
  193. document->completely_finish_loading();
  194. // 21. Return browsingContext and document.
  195. return BrowsingContext::BrowsingContextAndDocument { browsing_context, document };
  196. }
  197. BrowsingContext::BrowsingContext(Page& page, HTML::NavigableContainer* container)
  198. : m_page(page)
  199. , m_loader(*this)
  200. , m_event_handler({}, *this)
  201. , m_container(container)
  202. {
  203. m_cursor_blink_timer = Core::Timer::create_repeating(500, [this] {
  204. if (!is_focused_context())
  205. return;
  206. if (m_cursor_position.node() && m_cursor_position.node()->layout_node()) {
  207. m_cursor_blink_state = !m_cursor_blink_state;
  208. m_cursor_position.node()->layout_node()->set_needs_display();
  209. }
  210. }).release_value_but_fixme_should_propagate_errors();
  211. }
  212. BrowsingContext::~BrowsingContext() = default;
  213. void BrowsingContext::visit_edges(Cell::Visitor& visitor)
  214. {
  215. Base::visit_edges(visitor);
  216. for (auto& entry : m_session_history)
  217. visitor.visit(entry);
  218. visitor.visit(m_container);
  219. visitor.visit(m_window_proxy);
  220. visitor.visit(m_opener_browsing_context);
  221. visitor.visit(m_group);
  222. visitor.visit(m_parent);
  223. visitor.visit(m_first_child);
  224. visitor.visit(m_last_child);
  225. visitor.visit(m_next_sibling);
  226. visitor.visit(m_previous_sibling);
  227. }
  228. // https://html.spec.whatwg.org/multipage/document-sequences.html#bc-traversable
  229. JS::NonnullGCPtr<HTML::TraversableNavigable> BrowsingContext::top_level_traversable() const
  230. {
  231. // A browsing context's top-level traversable is its active document's node navigable's top-level traversable.
  232. auto traversable = active_document()->navigable()->top_level_traversable();
  233. VERIFY(traversable);
  234. VERIFY(traversable->is_top_level_traversable());
  235. return *traversable;
  236. }
  237. void BrowsingContext::did_edit(Badge<EditEventHandler>)
  238. {
  239. reset_cursor_blink_cycle();
  240. if (m_cursor_position.node() && is<DOM::Text>(*m_cursor_position.node())) {
  241. auto& text_node = static_cast<DOM::Text&>(*m_cursor_position.node());
  242. if (auto* text_node_owner = text_node.editable_text_node_owner())
  243. text_node_owner->did_edit_text_node({});
  244. }
  245. }
  246. void BrowsingContext::reset_cursor_blink_cycle()
  247. {
  248. m_cursor_blink_state = true;
  249. m_cursor_blink_timer->restart();
  250. if (m_cursor_position.is_valid() && m_cursor_position.node()->layout_node())
  251. m_cursor_position.node()->layout_node()->set_needs_display();
  252. }
  253. // https://html.spec.whatwg.org/multipage/browsers.html#top-level-browsing-context
  254. bool BrowsingContext::is_top_level() const
  255. {
  256. // A browsing context that has no parent browsing context is the top-level browsing context for itself and all of the browsing contexts for which it is an ancestor browsing context.
  257. return !parent();
  258. }
  259. bool BrowsingContext::is_focused_context() const
  260. {
  261. return m_page && &m_page->focused_context() == this;
  262. }
  263. void BrowsingContext::scroll_to(CSSPixelPoint position)
  264. {
  265. // NOTE: Scrolling to a position requires up-to-date layout *unless* we're scrolling to (0, 0)
  266. // as (0, 0) is always guaranteed to be a valid scroll position.
  267. if (!position.is_zero()) {
  268. if (active_document())
  269. active_document()->update_layout();
  270. }
  271. if (m_page && this == &m_page->top_level_browsing_context())
  272. m_page->client().page_did_request_scroll_to(position);
  273. }
  274. void BrowsingContext::scroll_to_anchor(DeprecatedString const& fragment)
  275. {
  276. JS::GCPtr<DOM::Document> document = active_document();
  277. if (!document)
  278. return;
  279. auto element = document->get_element_by_id(fragment);
  280. if (!element) {
  281. auto candidates = document->get_elements_by_name(MUST(String::from_deprecated_string(fragment)));
  282. for (auto& candidate : candidates->collect_matching_elements()) {
  283. if (is<HTML::HTMLAnchorElement>(*candidate)) {
  284. element = &verify_cast<HTML::HTMLAnchorElement>(*candidate);
  285. break;
  286. }
  287. }
  288. }
  289. if (!element)
  290. return;
  291. document->update_layout();
  292. if (!element->layout_node())
  293. return;
  294. auto& layout_node = *element->layout_node();
  295. auto const viewport_rect = document->viewport_rect();
  296. CSSPixelRect target_rect { layout_node.box_type_agnostic_position(), { viewport_rect.width(), viewport_rect.height() } };
  297. if (is<Layout::Box>(layout_node)) {
  298. auto& layout_box = verify_cast<Layout::Box>(layout_node);
  299. auto padding_box = layout_box.box_model().padding_box();
  300. target_rect.translate_by(-padding_box.left, -padding_box.top);
  301. }
  302. if (m_page && this == &m_page->top_level_browsing_context())
  303. m_page->client().page_did_request_scroll_into_view(target_rect);
  304. }
  305. JS::GCPtr<BrowsingContext> BrowsingContext::top_level_browsing_context() const
  306. {
  307. auto const* start = this;
  308. // 1. If start's active document is not fully active, then return null.
  309. if (!start->active_document()->is_fully_active()) {
  310. return nullptr;
  311. }
  312. // 2. Let navigable be start's active document's node navigable.
  313. auto navigable = start->active_document()->navigable();
  314. // 3. While navigable's parent is not null, set navigable to navigable's parent.
  315. while (navigable->parent()) {
  316. navigable = navigable->parent();
  317. }
  318. // 4. Return navigable's active browsing context.
  319. return navigable->active_browsing_context();
  320. }
  321. CSSPixelRect BrowsingContext::to_top_level_rect(CSSPixelRect const& a_rect)
  322. {
  323. auto rect = a_rect;
  324. rect.set_location(to_top_level_position(a_rect.location()));
  325. return rect;
  326. }
  327. CSSPixelPoint BrowsingContext::to_top_level_position(CSSPixelPoint a_position)
  328. {
  329. auto position = a_position;
  330. for (auto ancestor = parent(); ancestor; ancestor = ancestor->parent()) {
  331. if (ancestor->is_top_level())
  332. break;
  333. if (!ancestor->container())
  334. return {};
  335. if (!ancestor->container()->layout_node())
  336. return {};
  337. position.translate_by(ancestor->container()->layout_node()->box_type_agnostic_position());
  338. }
  339. return position;
  340. }
  341. void BrowsingContext::set_cursor_position(DOM::Position position)
  342. {
  343. if (m_cursor_position == position)
  344. return;
  345. if (m_cursor_position.node() && m_cursor_position.node()->layout_node())
  346. m_cursor_position.node()->layout_node()->set_needs_display();
  347. m_cursor_position = move(position);
  348. if (m_cursor_position.node() && m_cursor_position.node()->layout_node())
  349. m_cursor_position.node()->layout_node()->set_needs_display();
  350. reset_cursor_blink_cycle();
  351. }
  352. static DeprecatedString visible_text_in_range(DOM::Range const& range)
  353. {
  354. // NOTE: This is an adaption of Range stringification, but we skip over DOM nodes that don't have a corresponding layout node.
  355. StringBuilder builder;
  356. if (range.start_container() == range.end_container() && is<DOM::Text>(*range.start_container())) {
  357. if (!range.start_container()->layout_node())
  358. return ""sv;
  359. return static_cast<DOM::Text const&>(*range.start_container()).data().substring(range.start_offset(), range.end_offset() - range.start_offset());
  360. }
  361. if (is<DOM::Text>(*range.start_container()) && range.start_container()->layout_node())
  362. builder.append(static_cast<DOM::Text const&>(*range.start_container()).data().substring_view(range.start_offset()));
  363. for (DOM::Node const* node = range.start_container(); node != range.end_container()->next_sibling(); node = node->next_in_pre_order()) {
  364. if (is<DOM::Text>(*node) && range.contains_node(*node) && node->layout_node())
  365. builder.append(static_cast<DOM::Text const&>(*node).data());
  366. }
  367. if (is<DOM::Text>(*range.end_container()) && range.end_container()->layout_node())
  368. builder.append(static_cast<DOM::Text const&>(*range.end_container()).data().substring_view(0, range.end_offset()));
  369. return builder.to_deprecated_string();
  370. }
  371. DeprecatedString BrowsingContext::selected_text() const
  372. {
  373. auto* document = active_document();
  374. if (!document)
  375. return ""sv;
  376. auto selection = const_cast<DOM::Document&>(*document).get_selection();
  377. auto range = selection->range();
  378. if (!range)
  379. return ""sv;
  380. return visible_text_in_range(*range);
  381. }
  382. void BrowsingContext::select_all()
  383. {
  384. auto* document = active_document();
  385. if (!document)
  386. return;
  387. auto* body = document->body();
  388. if (!body)
  389. return;
  390. auto selection = document->get_selection();
  391. if (!selection)
  392. return;
  393. (void)selection->select_all_children(*document->body());
  394. }
  395. void BrowsingContext::register_frame_nesting(AK::URL const& url)
  396. {
  397. m_frame_nesting_levels.ensure(url)++;
  398. }
  399. bool BrowsingContext::is_frame_nesting_allowed(AK::URL const& url) const
  400. {
  401. return m_frame_nesting_levels.get(url).value_or(0) < 3;
  402. }
  403. bool BrowsingContext::increment_cursor_position_offset()
  404. {
  405. if (!m_cursor_position.increment_offset())
  406. return false;
  407. reset_cursor_blink_cycle();
  408. return true;
  409. }
  410. bool BrowsingContext::decrement_cursor_position_offset()
  411. {
  412. if (!m_cursor_position.decrement_offset())
  413. return false;
  414. reset_cursor_blink_cycle();
  415. return true;
  416. }
  417. // https://html.spec.whatwg.org/#rendering-opportunity
  418. bool BrowsingContext::has_a_rendering_opportunity() const
  419. {
  420. // A browsing context has a rendering opportunity if the user agent is currently able to present the contents of the browsing context to the user,
  421. // accounting for hardware refresh rate constraints and user agent throttling for performance reasons, but considering content presentable even if it's outside the viewport.
  422. // FIXME: We should at the very least say `false` here if we're an inactive browser tab.
  423. return true;
  424. }
  425. // https://html.spec.whatwg.org/multipage/interaction.html#currently-focused-area-of-a-top-level-browsing-context
  426. JS::GCPtr<DOM::Node> BrowsingContext::currently_focused_area()
  427. {
  428. // 1. If topLevelBC does not have system focus, then return null.
  429. if (!is_focused_context())
  430. return nullptr;
  431. // 2. Let candidate be topLevelBC's active document.
  432. auto* candidate = active_document();
  433. // 3. While candidate's focused area is a browsing context container with a non-null nested browsing context:
  434. // set candidate to the active document of that browsing context container's nested browsing context.
  435. while (candidate->focused_element()
  436. && is<HTML::NavigableContainer>(candidate->focused_element())
  437. && static_cast<HTML::NavigableContainer&>(*candidate->focused_element()).nested_browsing_context()) {
  438. candidate = static_cast<HTML::NavigableContainer&>(*candidate->focused_element()).nested_browsing_context()->active_document();
  439. }
  440. // 4. If candidate's focused area is non-null, set candidate to candidate's focused area.
  441. if (candidate->focused_element()) {
  442. // NOTE: We return right away here instead of assigning to candidate,
  443. // since that would require compromising type safety.
  444. return candidate->focused_element();
  445. }
  446. // 5. Return candidate.
  447. return candidate;
  448. }
  449. // https://html.spec.whatwg.org/#the-rules-for-choosing-a-browsing-context-given-a-browsing-context-name
  450. BrowsingContext::ChosenBrowsingContext BrowsingContext::choose_a_browsing_context(StringView name, TokenizedFeature::NoOpener no_opener, ActivateTab activate_tab)
  451. {
  452. // The rules for choosing a browsing context, given a browsing context name name, a browsing context current, and
  453. // a boolean noopener are as follows:
  454. JS::GCPtr<AbstractBrowsingContext> matching_name_in_tree = nullptr;
  455. top_level_browsing_context()->for_each_in_subtree([&](auto& context) {
  456. if (context.name() == name) {
  457. matching_name_in_tree = &context;
  458. return IterationDecision::Break;
  459. }
  460. return IterationDecision::Continue;
  461. });
  462. // 1. Let chosen be null.
  463. JS::GCPtr<AbstractBrowsingContext> chosen = nullptr;
  464. // 2. Let windowType be "existing or none".
  465. auto window_type = WindowType::ExistingOrNone;
  466. // 3. Let sandboxingFlagSet be current's active document's active sandboxing flag set.
  467. auto sandboxing_flag_set = active_document()->active_sandboxing_flag_set();
  468. // 4. If name is the empty string or an ASCII case-insensitive match for "_self", then set chosen to current.
  469. if (name.is_empty() || Infra::is_ascii_case_insensitive_match(name, "_self"sv)) {
  470. chosen = this;
  471. }
  472. // 5. Otherwise, if name is an ASCII case-insensitive match for "_parent", set chosen to current's parent browsing
  473. // context, if any, and current otherwise.
  474. else if (Infra::is_ascii_case_insensitive_match(name, "_parent"sv)) {
  475. if (auto parent = this->parent())
  476. chosen = parent;
  477. else
  478. chosen = this;
  479. }
  480. // 6. Otherwise, if name is an ASCII case-insensitive match for "_top", set chosen to current's top-level browsing
  481. // context, if any, and current otherwise.
  482. else if (Infra::is_ascii_case_insensitive_match(name, "_top"sv)) {
  483. chosen = top_level_browsing_context();
  484. }
  485. // 7. Otherwise, if name is not an ASCII case-insensitive match for "_blank", there exists a browsing context
  486. // whose name is the same as name, current is familiar with that browsing context, and the user agent
  487. // determines that the two browsing contexts are related enough that it is ok if they reach each other,
  488. // set chosen to that browsing context. If there are multiple matching browsing contexts, the user agent
  489. // should set chosen to one in some arbitrary consistent manner, such as the most recently opened, most
  490. // recently focused, or more closely related.
  491. else if (!Infra::is_ascii_case_insensitive_match(name, "_blank"sv) && matching_name_in_tree) {
  492. chosen = matching_name_in_tree;
  493. } else {
  494. // 8. Otherwise, a new browsing context is being requested, and what happens depends on the user agent's
  495. // configuration and abilities — it is determined by the rules given for the first applicable option from
  496. // the following list:
  497. // --> If current's active window does not have transient activation and the user agent has been configured to
  498. // not show popups (i.e., the user agent has a "popup blocker" enabled)
  499. VERIFY(m_page);
  500. if (!active_window()->has_transient_activation() && m_page->should_block_pop_ups()) {
  501. // FIXME: The user agent may inform the user that a popup has been blocked.
  502. dbgln("Pop-up blocked!");
  503. }
  504. // --> If sandboxingFlagSet has the sandboxed auxiliary navigation browsing context flag set
  505. else if (has_flag(sandboxing_flag_set, SandboxingFlagSet::SandboxedAuxiliaryNavigation)) {
  506. // FIXME: The user agent may report to a developer console that a popup has been blocked.
  507. dbgln("Pop-up blocked!");
  508. }
  509. // --> If the user agent has been configured such that in this instance it will create a new browsing context
  510. else if (true) { // FIXME: When is this the case?
  511. // 1. Set windowType to "new and unrestricted".
  512. window_type = WindowType::NewAndUnrestricted;
  513. // 2. If current's top-level browsing context's active document's cross-origin opener policy's value is
  514. // "same-origin" or "same-origin-plus-COEP", then:
  515. if (top_level_browsing_context()->active_document()->cross_origin_opener_policy().value == CrossOriginOpenerPolicyValue::SameOrigin || top_level_browsing_context()->active_document()->cross_origin_opener_policy().value == CrossOriginOpenerPolicyValue::SameOriginPlusCOEP) {
  516. // 1. Let currentDocument be current's active document.
  517. auto* current_document = top_level_browsing_context()->active_document();
  518. // 2. If currentDocument's origin is not same origin with currentDocument's relevant settings object's
  519. // top-level origin, then set noopener to true, name to "_blank", and windowType to "new with no opener".
  520. if (!current_document->origin().is_same_origin(current_document->relevant_settings_object().top_level_origin)) {
  521. no_opener = TokenizedFeature::NoOpener::Yes;
  522. name = "_blank"sv;
  523. window_type = WindowType::NewWithNoOpener;
  524. }
  525. }
  526. // 3. If noopener is true, then set chosen to the result of creating a new top-level browsing context.
  527. if (no_opener == TokenizedFeature::NoOpener::Yes) {
  528. auto handle = m_page->client().page_did_request_new_tab(activate_tab);
  529. chosen = RemoteBrowsingContext::create_a_new_remote_browsing_context(handle);
  530. }
  531. // 4. Otherwise:
  532. else {
  533. // 1. Set chosen to the result of creating a new auxiliary browsing context with current.
  534. // FIXME: We have no concept of auxiliary browsing context
  535. chosen = HTML::create_a_new_top_level_browsing_context_and_document(*m_page).release_value_but_fixme_should_propagate_errors().browsing_context;
  536. // 2. If sandboxingFlagSet's sandboxed navigation browsing context flag is set, then current must be
  537. // set as chosen's one permitted sandboxed navigator.
  538. // FIXME: We have no concept of one permitted sandboxed navigator
  539. }
  540. // 5. If sandboxingFlagSet's sandbox propagates to auxiliary browsing contexts flag is set, then all the
  541. // flags that are set in sandboxingFlagSet must be set in chosen's popup sandboxing flag set.
  542. // FIXME: Our BrowsingContexts do not have SandboxingFlagSets yet, only documents do
  543. // 6. If name is not an ASCII case-insensitive match for "_blank", then set chosen's name to name.
  544. if (!Infra::is_ascii_case_insensitive_match(name, "_blank"sv))
  545. chosen->set_name(String::from_utf8(name).release_value_but_fixme_should_propagate_errors());
  546. }
  547. // --> If the user agent has been configured such that in this instance t will reuse current
  548. else if (false) { // FIXME: When is this the case?
  549. // Set chosen to current.
  550. chosen = *this;
  551. }
  552. // --> If the user agent has been configured such that in this instance it will not find a browsing context
  553. else if (false) { // FIXME: When is this the case?
  554. // Do nothing.
  555. }
  556. }
  557. // 9. Return chosen and windowType.
  558. return { chosen.ptr(), window_type };
  559. }
  560. // https://html.spec.whatwg.org/multipage/dom.html#still-on-its-initial-about:blank-document
  561. bool BrowsingContext::still_on_its_initial_about_blank_document() const
  562. {
  563. // A browsing context browsingContext is still on its initial about:blank Document
  564. // if browsingContext's session history's size is 1
  565. // and browsingContext's session history[0]'s document's is initial about:blank is true.
  566. return m_session_history.size() == 1
  567. && m_session_history[0]->document_state->document()
  568. && m_session_history[0]->document_state->document()->is_initial_about_blank();
  569. }
  570. DOM::Document const* BrowsingContext::active_document() const
  571. {
  572. auto* window = active_window();
  573. if (!window)
  574. return nullptr;
  575. return &window->associated_document();
  576. }
  577. DOM::Document* BrowsingContext::active_document()
  578. {
  579. auto* window = active_window();
  580. if (!window)
  581. return nullptr;
  582. return &window->associated_document();
  583. }
  584. // https://html.spec.whatwg.org/multipage/browsers.html#active-window
  585. HTML::Window* BrowsingContext::active_window()
  586. {
  587. return m_window_proxy->window();
  588. }
  589. // https://html.spec.whatwg.org/multipage/browsers.html#active-window
  590. HTML::Window const* BrowsingContext::active_window() const
  591. {
  592. return m_window_proxy->window();
  593. }
  594. HTML::WindowProxy* BrowsingContext::window_proxy()
  595. {
  596. return m_window_proxy.ptr();
  597. }
  598. HTML::WindowProxy const* BrowsingContext::window_proxy() const
  599. {
  600. return m_window_proxy.ptr();
  601. }
  602. void BrowsingContext::set_window_proxy(JS::GCPtr<WindowProxy> window_proxy)
  603. {
  604. m_window_proxy = move(window_proxy);
  605. }
  606. void BrowsingContext::scroll_offset_did_change()
  607. {
  608. // https://w3c.github.io/csswg-drafts/cssom-view-1/#scrolling-events
  609. // Whenever a viewport gets scrolled (whether in response to user interaction or by an API), the user agent must run these steps:
  610. // 1. Let doc be the viewport’s associated Document.
  611. auto* doc = active_document();
  612. VERIFY(doc);
  613. // 2. If doc is already in doc’s pending scroll event targets, abort these steps.
  614. for (auto& target : doc->pending_scroll_event_targets()) {
  615. if (target.ptr() == doc)
  616. return;
  617. }
  618. // 3. Append doc to doc’s pending scroll event targets.
  619. doc->pending_scroll_event_targets().append(*doc);
  620. }
  621. BrowsingContextGroup* BrowsingContext::group()
  622. {
  623. return m_group;
  624. }
  625. void BrowsingContext::set_group(BrowsingContextGroup* group)
  626. {
  627. m_group = group;
  628. }
  629. // https://html.spec.whatwg.org/multipage/browsers.html#bcg-remove
  630. void BrowsingContext::remove()
  631. {
  632. // 1. Assert: browsingContext's group is non-null, because a browsing context only gets discarded once.
  633. VERIFY(group());
  634. // 2. Let group be browsingContext's group.
  635. JS::NonnullGCPtr<BrowsingContextGroup> group = *this->group();
  636. // 3. Set browsingContext's group to null.
  637. set_group(nullptr);
  638. // 4. Remove browsingContext from group's browsing context set.
  639. group->browsing_context_set().remove(*this);
  640. // 5. If group's browsing context set is empty, then remove group from the user agent's browsing context group set.
  641. // NOTE: This is done by ~BrowsingContextGroup() when the refcount reaches 0.
  642. }
  643. // https://html.spec.whatwg.org/multipage/origin.html#one-permitted-sandboxed-navigator
  644. BrowsingContext const* BrowsingContext::the_one_permitted_sandboxed_navigator() const
  645. {
  646. // FIXME: Implement this.
  647. return nullptr;
  648. }
  649. // https://html.spec.whatwg.org/multipage/browsers.html#document-family
  650. Vector<JS::Handle<DOM::Document>> BrowsingContext::document_family() const
  651. {
  652. HashTable<DOM::Document*> documents;
  653. for (auto& entry : m_session_history) {
  654. if (!entry->document_state->document())
  655. continue;
  656. if (documents.set(const_cast<DOM::Document*>(entry->document_state->document().ptr())) == AK::HashSetResult::ReplacedExistingEntry)
  657. continue;
  658. for (auto& context : entry->document_state->document()->list_of_descendant_browsing_contexts()) {
  659. for (auto& document : context->document_family()) {
  660. documents.set(document.ptr());
  661. }
  662. }
  663. }
  664. Vector<JS::Handle<DOM::Document>> family;
  665. for (auto* document : documents) {
  666. family.append(*document);
  667. }
  668. return family;
  669. }
  670. // https://html.spec.whatwg.org/multipage/browsers.html#document-family
  671. bool BrowsingContext::document_family_contains(DOM::Document const& document) const
  672. {
  673. return document_family().first_matching([&](auto& entry) { return entry.ptr() == &document; }).has_value();
  674. }
  675. VisibilityState BrowsingContext::system_visibility_state() const
  676. {
  677. return m_system_visibility_state;
  678. }
  679. // https://html.spec.whatwg.org/multipage/interaction.html#system-visibility-state
  680. void BrowsingContext::set_system_visibility_state(VisibilityState visibility_state)
  681. {
  682. if (m_system_visibility_state == visibility_state)
  683. return;
  684. m_system_visibility_state = visibility_state;
  685. // When a user-agent determines that the system visibility state for top-level browsing context context
  686. // has changed to newState, it must queue a task on the user interaction task source to update
  687. // the visibility state of all the Document objects in the top-level browsing context's document family with newState.
  688. auto document_family = top_level_browsing_context()->document_family();
  689. // From the new navigable version, where it tells us what global object to use here:
  690. // 1. Let document be navigable's active document.
  691. // 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.
  692. // FIXME: Update this function to fully match the navigable version.
  693. VERIFY(active_document());
  694. queue_global_task(Task::Source::UserInteraction, relevant_global_object(*active_document()), [visibility_state, document_family = move(document_family)] {
  695. for (auto& document : document_family) {
  696. document->update_the_visibility_state(visibility_state);
  697. }
  698. });
  699. }
  700. void BrowsingContext::append_child(JS::NonnullGCPtr<BrowsingContext> child)
  701. {
  702. VERIFY(!child->m_parent);
  703. if (m_last_child)
  704. m_last_child->m_next_sibling = child;
  705. child->m_previous_sibling = m_last_child;
  706. child->m_parent = this;
  707. m_last_child = child;
  708. if (!m_first_child)
  709. m_first_child = m_last_child;
  710. }
  711. void BrowsingContext::remove_child(JS::NonnullGCPtr<BrowsingContext> child)
  712. {
  713. VERIFY(child->m_parent.ptr() == this);
  714. if (m_first_child == child)
  715. m_first_child = child->m_next_sibling;
  716. if (m_last_child == child)
  717. m_last_child = child->m_previous_sibling;
  718. if (child->m_next_sibling)
  719. child->m_next_sibling->m_previous_sibling = child->m_previous_sibling;
  720. if (child->m_previous_sibling)
  721. child->m_previous_sibling->m_next_sibling = child->m_next_sibling;
  722. child->m_next_sibling = nullptr;
  723. child->m_previous_sibling = nullptr;
  724. child->m_parent = nullptr;
  725. }
  726. JS::GCPtr<BrowsingContext> BrowsingContext::first_child() const
  727. {
  728. return m_first_child;
  729. }
  730. JS::GCPtr<BrowsingContext> BrowsingContext::next_sibling() const
  731. {
  732. return m_next_sibling;
  733. }
  734. bool BrowsingContext::is_ancestor_of(BrowsingContext const& other) const
  735. {
  736. for (auto ancestor = other.parent(); ancestor; ancestor = ancestor->parent()) {
  737. if (ancestor == this)
  738. return true;
  739. }
  740. return false;
  741. }
  742. // https://html.spec.whatwg.org/multipage/browsing-the-web.html#snapshotting-target-snapshot-params
  743. SandboxingFlagSet determine_the_creation_sandboxing_flags(BrowsingContext const&, JS::GCPtr<DOM::Element>)
  744. {
  745. // FIXME: Populate this once we have the proper flag sets on BrowsingContext
  746. return {};
  747. }
  748. }