From 130e4bb7f69d1c508d51708fe0782ff839727c86 Mon Sep 17 00:00:00 2001
From: Yagiz Nizipli <yagiz@nizipli.com>
Date: Thu, 4 Jul 2024 16:17:08 -0400
Subject: [PATCH 1/3] url: add missing documentation for `URL.parse()`

---
 doc/api/url.md | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/doc/api/url.md b/doc/api/url.md
index 53484e1a856395..be202d2fda0a1d 100644
--- a/doc/api/url.md
+++ b/doc/api/url.md
@@ -691,6 +691,23 @@ const isValid = URL.canParse('/foo', 'https://example.org/'); // true
 const isNotValid = URL.canParse('/foo'); // false
 ```
 
+#### `URL.parse(input[, base])`
+
+<!-- YAML
+added: v22.1.0
+-->
+
+* `input` {string} The absolute or relative input URL to parse. If `input`
+  is relative, then `base` is required. If `input` is absolute, the `base`
+  is ignored. If `input` is not a string, it is [converted to a string][] first.
+* `base` {string} The base URL to resolve against if the `input` is not
+  absolute. If `base` is not a string, it is [converted to a string][] first.
+* Returns: {URL|undefined}
+
+Parses a string as a URL. If `base` is provided, it will be used as the base
+URL for the purpose of resolving non-absolute `input` URLs. Returns `undefined`
+if `input` is not a valid.
+
 ### Class: `URLSearchParams`
 
 <!-- YAML

From cc6cca8a589669a7774ee9756b6853799528040c Mon Sep 17 00:00:00 2001
From: Yagiz Nizipli <yagiz@nizipli.com>
Date: Thu, 4 Jul 2024 20:26:25 -0400
Subject: [PATCH 2/3] Update url.md

Co-authored-by: Khafra <maitken033380023@gmail.com>
---
 doc/api/url.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/url.md b/doc/api/url.md
index be202d2fda0a1d..16dba3c8789992 100644
--- a/doc/api/url.md
+++ b/doc/api/url.md
@@ -702,7 +702,7 @@ added: v22.1.0
   is ignored. If `input` is not a string, it is [converted to a string][] first.
 * `base` {string} The base URL to resolve against if the `input` is not
   absolute. If `base` is not a string, it is [converted to a string][] first.
-* Returns: {URL|undefined}
+* Returns: {URL|null}
 
 Parses a string as a URL. If `base` is provided, it will be used as the base
 URL for the purpose of resolving non-absolute `input` URLs. Returns `undefined`

From dc40656e58a102ad8f31adf27dcd47cfbe2e5494 Mon Sep 17 00:00:00 2001
From: Yagiz Nizipli <yagiz@nizipli.com>
Date: Thu, 4 Jul 2024 20:27:04 -0400
Subject: [PATCH 3/3] Update url.md

---
 doc/api/url.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/doc/api/url.md b/doc/api/url.md
index 16dba3c8789992..60e9a02bd6c61a 100644
--- a/doc/api/url.md
+++ b/doc/api/url.md
@@ -705,7 +705,7 @@ added: v22.1.0
 * Returns: {URL|null}
 
 Parses a string as a URL. If `base` is provided, it will be used as the base
-URL for the purpose of resolving non-absolute `input` URLs. Returns `undefined`
+URL for the purpose of resolving non-absolute `input` URLs. Returns `null`
 if `input` is not a valid.
 
 ### Class: `URLSearchParams`