Stowage/ladybird
2
0
Fork 0
mirror of https://github.com/LadybirdBrowser/ladybird.git synced 2025-10-31 05:10:57 +00:00
Code Issues Projects Releases Packages Wiki Activity
ladybird/Libraries/LibWeb/DOMURL/DOMURL.h

104 lines
3.5 KiB
C
Raw Normal View History

LibWeb: Add the Web::URL namespace and move URLEncoder to it This namespace will be used for all interfaces defined in the URL specification, like URL and URLSearchParams. This has the unfortunate side-effect of requiring us to use the fully qualified AK::URL name whenever we want to refer to the AK class, so this commit also fixes all such references.
2021-09-13 00:33:23 +03:00
/*
* Copyright (c) 2021, Idan Horowitz <idan.horowitz@serenityos.org>
* Copyright (c) 2021, the SerenityOS developers.
LibWeb: Implement URL.canParse(url, base) This patch adds an implementation of the URL.canParse(url, base) static function :^)
2023-04-11 14:57:34 +02:00
* Copyright (c) 2023, networkException <networkexception@serenityos.org>
LibWeb: Factor out an 'initialize a URL' AO This is a small refactor in the URL spec to avoid duplication as part of the introduction of URL.parse, see: https://github.com/whatwg/url/commit/58acb0
2024-05-13 16:09:58 +12:00
* Copyright (c) 2024, Shannon Booth <shannon@serenityos.org>
LibWeb: Add the Web::URL namespace and move URLEncoder to it This namespace will be used for all interfaces defined in the URL specification, like URL and URLSearchParams. This has the unfortunate side-effect of requiring us to use the fully qualified AK::URL name whenever we want to refer to the AK class, so this commit also fixes all such references.
2021-09-13 00:33:23 +03:00
*
* SPDX-License-Identifier: BSD-2-Clause
*/
#pragma once
AK+LibURL: Move AK::URL into a new URL library This URL library ends up being a relatively fundamental base library of the system, as LibCore depends on LibURL. This change has two main benefits: * Moving AK back more towards being an agnostic library that can be used between the kernel and userspace. URL has never really fit that description - and is not used in the kernel. * URL _should_ depend on LibUnicode, as it needs punnycode support. However, it's not really possible to do this inside of AK as it can't depend on any external library. This change brings us a little closer to being able to do that, but unfortunately we aren't there quite yet, as the code generators depend on LibCore.
2024-03-18 16:22:27 +13:00
#include <LibURL/URL.h>
LibWeb: Make URL, URLSearchParams & URLSearchParamsIterator GC-allocated
2022-09-04 14:04:42 +02:00
#include <LibWeb/Bindings/PlatformObject.h>
LibWeb: Rename URL platform object to DOMURL Along with putting functions in the URL namespace into a DOMURL namespace. This is done as LibWeb is in an awkward situation where it needs two URL classes. AK::URL is the general purpose URL class which is all that is needed in 95% of cases. URL in the Web namespace is needed predominantly for interfacing with the javascript interfaces. Because of two URLs in the same namespace, AK::URL has had to be used throughout LibWeb. If we move AK::URL into a URL namespace, this becomes more painful - where ::URL::URL is required to specify the constructor (and something like ::URL::create_with_url_or_path in other places). To fix this problem - rename the class in LibWeb implementing the URL IDL interface to DOMURL, along with moving the other Web URL related classes into this DOMURL folder. One could argue that this name also makes the situation a little more clear in LibWeb for why these two URL classes need be used in the first place.
2024-02-11 19:48:56 +13:00
#include <LibWeb/DOMURL/URLSearchParams.h>
LibWeb: Move ExceptionOr from DOM/ to WebIDL/ This is a concept fully defined in the Web IDL spec and doesn't belong in the DOM directory/namespace - not even DOMException, despite the name :^)
2022-09-25 17:03:42 +01:00
#include <LibWeb/WebIDL/ExceptionOr.h>
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
LibWeb: Rename URL platform object to DOMURL Along with putting functions in the URL namespace into a DOMURL namespace. This is done as LibWeb is in an awkward situation where it needs two URL classes. AK::URL is the general purpose URL class which is all that is needed in 95% of cases. URL in the Web namespace is needed predominantly for interfacing with the javascript interfaces. Because of two URLs in the same namespace, AK::URL has had to be used throughout LibWeb. If we move AK::URL into a URL namespace, this becomes more painful - where ::URL::URL is required to specify the constructor (and something like ::URL::create_with_url_or_path in other places). To fix this problem - rename the class in LibWeb implementing the URL IDL interface to DOMURL, along with moving the other Web URL related classes into this DOMURL folder. One could argue that this name also makes the situation a little more clear in LibWeb for why these two URL classes need be used in the first place.
2024-02-11 19:48:56 +13:00
namespace Web::DOMURL {
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
LibWeb: Rename URL platform object to DOMURL Along with putting functions in the URL namespace into a DOMURL namespace. This is done as LibWeb is in an awkward situation where it needs two URL classes. AK::URL is the general purpose URL class which is all that is needed in 95% of cases. URL in the Web namespace is needed predominantly for interfacing with the javascript interfaces. Because of two URLs in the same namespace, AK::URL has had to be used throughout LibWeb. If we move AK::URL into a URL namespace, this becomes more painful - where ::URL::URL is required to specify the constructor (and something like ::URL::create_with_url_or_path in other places). To fix this problem - rename the class in LibWeb implementing the URL IDL interface to DOMURL, along with moving the other Web URL related classes into this DOMURL folder. One could argue that this name also makes the situation a little more clear in LibWeb for why these two URL classes need be used in the first place.
2024-02-11 19:48:56 +13:00
class DOMURL : public Bindings::PlatformObject {
WEB_PLATFORM_OBJECT(DOMURL, Bindings::PlatformObject);
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
GC_DECLARE_ALLOCATOR(DOMURL);
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
LibWeb: Make URL, URLSearchParams & URLSearchParamsIterator GC-allocated
2022-09-04 14:04:42 +02:00
public:
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
[[nodiscard]] static GC::Ref<DOMURL> create(JS::Realm&, URL::URL, GC::Ref<URLSearchParams> query);
static WebIDL::ExceptionOr<GC::Ref<DOMURL>> construct_impl(JS::Realm&, String const& url, Optional<String> const& base = {});
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
LibWeb: Rename URL platform object to DOMURL Along with putting functions in the URL namespace into a DOMURL namespace. This is done as LibWeb is in an awkward situation where it needs two URL classes. AK::URL is the general purpose URL class which is all that is needed in 95% of cases. URL in the Web namespace is needed predominantly for interfacing with the javascript interfaces. Because of two URLs in the same namespace, AK::URL has had to be used throughout LibWeb. If we move AK::URL into a URL namespace, this becomes more painful - where ::URL::URL is required to specify the constructor (and something like ::URL::create_with_url_or_path in other places). To fix this problem - rename the class in LibWeb implementing the URL IDL interface to DOMURL, along with moving the other Web URL related classes into this DOMURL folder. One could argue that this name also makes the situation a little more clear in LibWeb for why these two URL classes need be used in the first place.
2024-02-11 19:48:56 +13:00
virtual ~DOMURL() override;
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
static WebIDL::ExceptionOr<String> create_object_url(JS::VM&, GC::Ref<FileAPI::Blob> object);
LibURL+LibWeb: Make URL::serialize return a String Simplifying a bunch of uneeded error handling around the place.
2024-12-03 22:31:33 +13:00
static void revoke_object_url(JS::VM&, StringView url);
LibWeb: Implement URL.createObjectURL and URL.revokeObjectURL
2023-08-01 18:49:32 -04:00
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
static GC::Ptr<DOMURL> parse_for_bindings(JS::VM&, String const& url, Optional<String> const& base = {});
LibWeb: Implement URL.canParse(url, base) This patch adds an implementation of the URL.canParse(url, base) static function :^)
2023-04-11 14:57:34 +02:00
static bool can_parse(JS::VM&, String const& url, Optional<String> const& base = {});
LibURL+LibWeb: Make URL::serialize return a String Simplifying a bunch of uneeded error handling around the place.
2024-12-03 22:31:33 +13:00
String href() const;
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<void> set_href(String const&);
LibWeb: Add the URL::href attribute and URL::to_json method
2021-09-14 00:13:32 +03:00
LibURL+LibWeb: Make URL serialization return a String This can only ever fail from OOM, and will never by string containing random byte sequences.
2024-11-23 20:10:34 +13:00
String origin() const;
LibWeb: Add the URL::username, URL::password & URL::origin attributes
2021-09-14 00:18:25 +03:00
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<String> protocol() const;
WebIDL::ExceptionOr<void> set_protocol(String const&);
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes
2021-09-14 00:21:51 +03:00
LibURL+LibWeb: Do not percent decode in password/username getters Doing it is not part of the spec. Whenever needed, the spec will explicitly percent decode the username and password. This fixes some URL WPT tests.
2024-08-04 22:02:02 +12:00
String const& username() const;
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
void set_username(String const&);
LibWeb: Add the URL::username, URL::password & URL::origin attributes
2021-09-14 00:18:25 +03:00
LibURL+LibWeb: Do not percent decode in password/username getters Doing it is not part of the spec. Whenever needed, the spec will explicitly percent decode the username and password. This fixes some URL WPT tests.
2024-08-04 22:02:02 +12:00
String const& password() const;
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
void set_password(String const&);
LibWeb: Add the URL::username, URL::password & URL::origin attributes
2021-09-14 00:18:25 +03:00
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<String> host() const;
void set_host(String const&);
LibWeb: Add the URL::host, URL::hostname & URL:port attributes
2021-09-14 00:21:29 +03:00
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<String> hostname() const;
void set_hostname(String const&);
LibWeb: Add the URL::host, URL::hostname & URL:port attributes
2021-09-14 00:21:29 +03:00
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<String> port() const;
void set_port(String const&);
LibWeb: Add the URL::host, URL::hostname & URL:port attributes
2021-09-14 00:21:29 +03:00
LibURL+Everywhere: Only percent decode URL paths when actually needed Web specs do not return through javascript percent decoded URL path components - but we were doing this in a number of places due to the default behaviour of URL::serialize_path. Since percent encoded URL paths may not contain valid UTF-8 - this was resulting in us crashing in these places. For example - on an HTMLAnchorElement when retrieving the pathname for the URL of: http://ladybird.org/foo%C2%91%91 To fix this make the URL class only return the percent encoded serialized path, matching the URL spec. When the decoded path is required instead explicitly call URL::percent_decode. This fixes a crash running WPT URL tests for the anchor element on: https://wpt.live/url/a-element.html
2024-08-05 16:55:39 +12:00
String pathname() const;
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
void set_pathname(String const&);
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes
2021-09-14 00:21:51 +03:00
LibWeb/URL: Add `strip_trailing_spaces_from_an_opaque_path()` Also remove 2 FIXMEs by including this function.
2023-09-10 16:50:29 -07:00
Optional<String> const& fragment() const { return m_url.fragment(); }
Everywhere: Rename {Deprecated => Byte}String This commit un-deprecates DeprecatedString, and repurposes it as a byte string. As the null state has already been removed, there are no other particularly hairy blockers in repurposing this type as a byte string (what it _really_ is). This commit is auto-generated: $ xs=$(ack -l \bDeprecatedString\b\|deprecated_string AK Userland \ Meta Ports Ladybird Tests Kernel) $ perl -pie 's/\bDeprecatedString\b/ByteString/g; s/deprecated_string/byte_string/g' $xs $ clang-format --style=file -i \ $(git diff --name-only | grep \.cpp\|\.h) $ gn format $(git ls-files '*.gn' '*.gni')
2023-12-16 17:49:34 +03:30
ByteString path_segment_at_index(size_t index) const { return m_url.path_segment_at_index(index); }
LibWeb/URL: Add `strip_trailing_spaces_from_an_opaque_path()` Also remove 2 FIXMEs by including this function.
2023-09-10 16:50:29 -07:00
Everywhere: Rename {Deprecated => Byte}String This commit un-deprecates DeprecatedString, and repurposes it as a byte string. As the null state has already been removed, there are no other particularly hairy blockers in repurposing this type as a byte string (what it _really_ is). This commit is auto-generated: $ xs=$(ack -l \bDeprecatedString\b\|deprecated_string AK Userland \ Meta Ports Ladybird Tests Kernel) $ perl -pie 's/\bDeprecatedString\b/ByteString/g; s/deprecated_string/byte_string/g' $xs $ clang-format --style=file -i \ $(git diff --name-only | grep \.cpp\|\.h) $ gn format $(git ls-files '*.gn' '*.gni')
2023-12-16 17:49:34 +03:30
void set_paths(Vector<ByteString> const& paths) { return m_url.set_paths(paths); }
LibWeb/URL: Add `strip_trailing_spaces_from_an_opaque_path()` Also remove 2 FIXMEs by including this function.
2023-09-10 16:50:29 -07:00
// FIXME: Reimplement this to meet the definition in https://url.spec.whatwg.org/#url-opaque-path once we modernize URL to meet the spec.
bool cannot_be_a_base_url() const { return m_url.cannot_be_a_base_url(); }
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<String> search() const;
LibWeb: Don't propogate small OOMs from URLSearchParams Made easier now that URL percent encode after encoding is also not throwing any errors. This simplfies a bunch of error handling.
2024-08-11 00:24:54 +12:00
void set_search(String const&);
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes
2021-09-14 00:21:51 +03:00
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
GC::Ref<URLSearchParams const> search_params() const;
LibWeb: Add the URL::searchParams attribute
2021-09-14 00:15:41 +03:00
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<String> hash() const;
void set_hash(String const&);
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes
2021-09-14 00:21:51 +03:00
LibURL+LibWeb: Make URL::serialize return a String Simplifying a bunch of uneeded error handling around the place.
2024-12-03 22:31:33 +13:00
String to_json() const;
LibWeb: Add the URL::href attribute and URL::to_json method
2021-09-14 00:13:32 +03:00
LibWeb/URL: Add `strip_trailing_spaces_from_an_opaque_path()` Also remove 2 FIXMEs by including this function.
2023-09-10 16:50:29 -07:00
Optional<String> const& query() const { return m_url.query(); }
AK: Port URL::m_query from DeprecatedString to String
2023-08-12 19:28:19 +12:00
void set_query(Badge<URLSearchParams>, Optional<String> query) { m_url.set_query(move(query)); }
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
private:
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
DOMURL(JS::Realm&, URL::URL, GC::Ref<URLSearchParams> query);
LibWeb: Make URL, URLSearchParams & URLSearchParamsIterator GC-allocated
2022-09-04 14:04:42 +02:00
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
static GC::Ref<DOMURL> initialize_a_url(JS::Realm&, URL::URL const&);
LibWeb: Factor out an 'initialize a URL' AO This is a small refactor in the URL spec to avoid duplication as part of the introduction of URL.parse, see: https://github.com/whatwg/url/commit/58acb0
2024-05-13 16:09:58 +12:00
LibJS: Make Cell::initialize() return void Stop worrying about tiny OOMs. Work towards #20405
2023-08-07 08:41:28 +02:00
virtual void initialize(JS::Realm&) override;
LibWeb: Make URL, URLSearchParams & URLSearchParamsIterator GC-allocated
2022-09-04 14:04:42 +02:00
virtual void visit_edges(Cell::Visitor&) override;
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
AK+LibURL: Move AK::URL into a new URL library This URL library ends up being a relatively fundamental base library of the system, as LibCore depends on LibURL. This change has two main benefits: * Moving AK back more towards being an agnostic library that can be used between the kernel and userspace. URL has never really fit that description - and is not used in the kernel. * URL _should_ depend on LibUnicode, as it needs punnycode support. However, it's not really possible to do this inside of AK as it can't depend on any external library. This change brings us a little closer to being able to do that, but unfortunately we aren't there quite yet, as the code generators depend on LibCore.
2024-03-18 16:22:27 +13:00
URL::URL m_url;
LibGC+Everywhere: Factor out a LibGC from LibJS Resulting in a massive rename across almost everywhere! Alongside the namespace change, we now have the following names: * JS::NonnullGCPtr -> GC::Ref * JS::GCPtr -> GC::Ptr * JS::HeapFunction -> GC::Function * JS::CellImpl -> GC::Cell * JS::Handle -> GC::Root
2024-11-15 04:01:23 +13:00
GC::Ref<URLSearchParams> m_query;
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now.
2021-09-14 00:10:22 +03:00
};
Everywhere: Use unqualified AK::URL Now possible in LibWeb now that there is no longer a Web::URL.
2024-02-11 20:15:39 +13:00
bool host_is_domain(URL::Host const&);
LibWeb: Move url_origin() to URL/URL.{cpp,h}
2022-10-13 18:25:00 +02:00
LibWeb/URL: Add `strip_trailing_spaces_from_an_opaque_path()` Also remove 2 FIXMEs by including this function.
2023-09-10 16:50:29 -07:00
// https://url.spec.whatwg.org/#potentially-strip-trailing-spaces-from-an-opaque-path
LibWeb: Rename URL platform object to DOMURL Along with putting functions in the URL namespace into a DOMURL namespace. This is done as LibWeb is in an awkward situation where it needs two URL classes. AK::URL is the general purpose URL class which is all that is needed in 95% of cases. URL in the Web namespace is needed predominantly for interfacing with the javascript interfaces. Because of two URLs in the same namespace, AK::URL has had to be used throughout LibWeb. If we move AK::URL into a URL namespace, this becomes more painful - where ::URL::URL is required to specify the constructor (and something like ::URL::create_with_url_or_path in other places). To fix this problem - rename the class in LibWeb implementing the URL IDL interface to DOMURL, along with moving the other Web URL related classes into this DOMURL folder. One could argue that this name also makes the situation a little more clear in LibWeb for why these two URL classes need be used in the first place.
2024-02-11 19:48:56 +13:00
void strip_trailing_spaces_from_an_opaque_path(DOMURL& url);
LibWeb/URL: Add `strip_trailing_spaces_from_an_opaque_path()` Also remove 2 FIXMEs by including this function.
2023-09-10 16:50:29 -07:00
LibWeb: Add interface for 'concept-url-parser' This does not implement extra functionality on top of the basic parser, but allows multiple places in LibWeb to call the 'correct' interface for when it is fully implemented.
2023-07-15 14:24:58 +12:00
// https://url.spec.whatwg.org/#concept-url-parser
AK: Don't implicitly convert Optional<T&> to Optional<T> C++ will jovially select the implicit conversion operator, even if it's complete bogus, such as for unknown-size types or non-destructible types. Therefore, all such conversions (which incur a copy) must (unfortunately) be explicit so that non-copyable types continue to work. NOTE: We make an exception for trivially copyable types, since they are, well, trivially copyable. Co-authored-by: kleines Filmröllchen <filmroellchen@serenityos.org>
2024-11-25 13:23:31 +01:00
URL::URL parse(StringView input, Optional<URL::URL const&> base_url = {}, Optional<StringView> encoding = {});
LibWeb: Add interface for 'concept-url-parser' This does not implement extra functionality on top of the basic parser, but allows multiple places in LibWeb to call the 'correct' interface for when it is fully implemented.
2023-07-15 14:24:58 +12:00
LibWeb: Add the Web::URL namespace and move URLEncoder to it This namespace will be used for all interfaces defined in the URL specification, like URL and URLSearchParams. This has the unfortunate side-effect of requiring us to use the fully qualified AK::URL name whenever we want to refer to the AK class, so this commit also fixes all such references.
2021-09-13 00:33:23 +03:00
}
Reference in a new issue Copy permalink