ladybird/Libraries/LibWeb/DOMURL/DOMURL.idl

#import <FileAPI/Blob.idl>
#import <DOMURL/URLSearchParams.idl>
#import <MediaSourceExtensions/MediaSource.idl>

// https://url.spec.whatwg.org/#url
[Exposed=*, LegacyWindowAlias=webkitURL, ImplementedAs=DOMURL]
interface URL {
    constructor(USVString url, optional USVString base);

    [ImplementedAs=parse_for_bindings] static DOMURL? parse(USVString url, optional USVString base);
    static boolean canParse(USVString url, optional USVString base);

    stringifier attribute USVString href;
    readonly attribute USVString origin;
    attribute USVString protocol;
    attribute USVString username;
    attribute USVString password;
    attribute USVString host;
    attribute USVString hostname;
    attribute USVString port;
    attribute USVString pathname;
    attribute USVString search;
    [SameObject] readonly attribute URLSearchParams searchParams;
    attribute USVString hash;

    USVString toJSON();

    static Utf16DOMString createObjectURL((Blob or MediaSource) obj);
    static undefined revokeObjectURL(DOMString url);
};
LibWeb: Implement URL.createObjectURL and URL.revokeObjectURL 2023-08-01 19:49:32 -03:00			`#import <FileAPI/Blob.idl>`
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 03:48:56 -03:00			`#import <DOMURL/URLSearchParams.idl>`
LibWeb/LibURL/LibIPC: Extend createObjectURL to also accept MediaSources This required some changes in LibURL & LibIPC since it has its own definition of an BlobURLEntry. For now, we don't have a concrete usage of MediaSource in LibURL so it is defined as an empty struct. This removes one FIXME in an idl file. 2025-08-17 19:37:34 -03:00			`#import <MediaSourceExtensions/MediaSource.idl>`
LibWeb: Add imports to all IDL files that depend on others 2022-02-15 16:10:51 -03:00
LibWeb: Add Exposed attribute and IDL spec links where missing The intent is to use these to autogenerate prototype declarations for Window and WorkerGlobalScope classes. And the spec links are just nice to have :^) 2022-10-07 19:45:09 -03:00			`// https://url.spec.whatwg.org/#url`
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 03:48:56 -03:00			`[Exposed=*, LegacyWindowAlias=webkitURL, ImplementedAs=DOMURL]`
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now. 2021-09-13 18:10:22 -03:00			`interface URL {`
			`constructor(USVString url, optional USVString base);`

LibWeb: Implement URL.parse This was an addition to the URL spec, see: https://github.com/whatwg/url/commit/58acb0 2024-05-13 01:10:19 -03:00			`[ImplementedAs=parse_for_bindings] static DOMURL? parse(USVString url, optional USVString base);`
LibWeb: Implement URL.canParse(url, base) This patch adds an implementation of the URL.canParse(url, base) static function :^) 2023-04-11 09:57:34 -03:00			`static boolean canParse(USVString url, optional USVString base);`

LibWeb: Add the URL::href attribute and URL::to_json method 2021-09-13 18:13:32 -03:00			`stringifier attribute USVString href;`
LibWeb: Add the URL::username, URL::password & URL::origin attributes 2021-09-13 18:18:25 -03:00			`readonly attribute USVString origin;`
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes 2021-09-13 18:21:51 -03:00			`attribute USVString protocol;`
LibWeb: Add the URL::username, URL::password & URL::origin attributes 2021-09-13 18:18:25 -03:00			`attribute USVString username;`
			`attribute USVString password;`
LibWeb: Add the URL::host, URL::hostname & URL:port attributes 2021-09-13 18:21:29 -03:00			`attribute USVString host;`
			`attribute USVString hostname;`
			`attribute USVString port;`
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes 2021-09-13 18:21:51 -03:00			`attribute USVString pathname;`
			`attribute USVString search;`
LibWeb: Add the URL::searchParams attribute 2021-09-13 18:15:41 -03:00			`[SameObject] readonly attribute URLSearchParams searchParams;`
LibWeb: Add the URL::{protocol, pathname, search, hash} attributes 2021-09-13 18:21:51 -03:00			`attribute USVString hash;`
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now. 2021-09-13 18:10:22 -03:00
LibWeb: Add the URL::href attribute and URL::to_json method 2021-09-13 18:13:32 -03:00			`USVString toJSON();`
LibWeb: Implement URL.createObjectURL and URL.revokeObjectURL 2023-08-01 19:49:32 -03:00
LibWeb/LibURL/LibIPC: Extend createObjectURL to also accept MediaSources This required some changes in LibURL & LibIPC since it has its own definition of an BlobURLEntry. For now, we don't have a concrete usage of MediaSource in LibURL so it is defined as an empty struct. This removes one FIXME in an idl file. 2025-08-17 19:37:34 -03:00			`static Utf16DOMString createObjectURL((Blob or MediaSource) obj);`
LibWeb: Implement URL.createObjectURL and URL.revokeObjectURL 2023-08-01 19:49:32 -03:00			`static undefined revokeObjectURL(DOMString url);`
LibWeb: Add a bare implementation of the URL built-in This only has the constructor implemented for now. 2021-09-13 18:10:22 -03:00			`};`