From dfdd05261b7bd40f190e04650e4cd9e35d30195e Mon Sep 17 00:00:00 2001
From: ruanyf <yifeng.ruan@gmail.com>
Date: Mon, 20 May 2024 11:40:22 +0800
Subject: [PATCH] docs(url): add URL.parse()

---
 docs/url.md | 16 +++++++++++++++-
 1 file changed, 15 insertions(+), 1 deletion(-)

diff --git a/docs/url.md b/docs/url.md
index 10244bd..1cba9dc 100644
--- a/docs/url.md
+++ b/docs/url.md
@@ -173,7 +173,7 @@ function handleFiles(files) {
 
 ### URL.canParse()
 
-`URL.canParse()`用来检测一个字符串是否为有效 URL，它返回一个布尔值。
+`URL()`构造函数解析非法网址时，会抛出错误，必须用`try...catch`代码块处理，这样终究不是非常方便。因此，URL 对象又引入了`URL.canParse()`方法，它返回一个布尔值，表示当前字符串是否为有效网址。
 
 ```javascipt
 URL.canParse(url)
@@ -217,6 +217,20 @@ function isUrlValid(string) {
 
 上面示例中，给出了`URL.canParse()`的替代实现`isUrlValid()`。
 
+### URL.parse()
+
+`URL.parse()`是一个新添加的方法，Chromium 126 和 Firefox 126 开始支持。
+
+它的主要目的就是，改变`URL()`构造函数解析非法网址抛错的问题。这个新方法不会抛错，如果参数是有效网址，则返回 URL 实例对象，否则返回`null`。
+
+```javascript
+const urlstring = "this is not a URL";
+
+const not_a_url = URL.parse(urlstring); // null
+```
+
+上面示例中，`URL.parse()`的参数不是有效网址，所以返回`null`。
+
 ## 实例方法
 
 ### toString()