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

105 lines
3.7 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);
JS_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:
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
[[nodiscard]] static JS::NonnullGCPtr<DOMURL> create(JS::Realm&, URL::URL, JS::NonnullGCPtr<URLSearchParams> query);
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
static WebIDL::ExceptionOr<JS::NonnullGCPtr<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
LibWeb: Implement URL.createObjectURL and URL.revokeObjectURL
2023-08-01 18:49:32 -04:00
static WebIDL::ExceptionOr<String> create_object_url(JS::VM&, JS::NonnullGCPtr<FileAPI::Blob> object);
static WebIDL::ExceptionOr<void> revoke_object_url(JS::VM&, StringView url);
LibWeb: Implement URL.parse This was an addition to the URL spec, see: https://github.com/whatwg/url/commit/58acb0
2024-05-13 16:10:19 +12:00
static JS::GCPtr<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 = {});
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<String> href() const;
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
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<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;
WebIDL::ExceptionOr<void> set_search(String const&);
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes
2021-09-14 00:21:51 +03:00
LibWeb/URL: Make URL::search_params() return a NonnullGCPtr
2023-04-12 23:20:27 +02:00
JS::NonnullGCPtr<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
LibWeb: Port URL and URLSearchParams to new String
2023-03-01 20:10:01 +01:00
WebIDL::ExceptionOr<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:
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
DOMURL(JS::Realm&, URL::URL, JS::NonnullGCPtr<URLSearchParams> query);
LibWeb: Make URL, URLSearchParams & URLSearchParamsIterator GC-allocated
2022-09-04 14:04:42 +02:00
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
static JS::NonnullGCPtr<DOMURL> initialize_a_url(JS::Realm&, URL::URL const&);
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;
LibWeb: Make URL, URLSearchParams & URLSearchParamsIterator GC-allocated
2022-09-04 14:04:42 +02:00
JS::NonnullGCPtr<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
};
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
HTML::Origin url_origin(URL::URL const&);
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
LibWeb: Use text encoding from DOM when parsing URLs This passes the DOM encoding down to the URL parser, so the correct encoder can be used.
2024-08-05 21:47:45 +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