大网数据广告活动
Web 标准与前端开发

URL:canParse() 静态方法

· 52CE 我爱测

URL 接口的 **`URL.canParse()`** 静态方法返回一个布尔值,表示绝对 URL 或与基本 URL 结合的相对地址是否可解析和有效。

URL API

URL 接口的 URL.canParse() 静态方法返回一个布尔值,表示绝对 URL 或与基本 URL 结合的相对地址是否可解析和有效。

这是在 try...catch 代码块中构造 URL 的快速而简单的替代方法。对于会使得 URL() 构造函数成功的相同值,它将返回 true,而对于会导致构造函数抛出的错误的值,它返回 false。

语法

URL.canParse(url)
URL.canParse(url, base)

参数

  • url
    • : 字符串或其他任何带有 stringifier 的对象(例如,包括 a 或 area 元素),表示绝对或相对 URL。如果 url 是相对 URL,则 base 为必填项,并将用作基本 URL。如果 url 是绝对 URL,给定的 base 将被忽略。
  • base
    • : 字符串,表示在 url 是相对 URL 的情况下使用的基本 URL。如果未指定,则默认为 undefined。

[!NOTE] url 和 base 参数将根据你传递的任何值进行字符串化,就像其他接受字符串的 Web API 一样。特别是,你可以使用一个现有的 URL 对象作为任一参数,它将被字符串化为该对象的 URL.href 属性。

返回值

如果 URL 可以解析且有效,则为 true;否则为 false。

示例

本示例演示了如何使用 URL.canParse() 静态方法来处理一些不同的绝对和相对 URL 的值。

示例的第一部分定义了记录日志的 HTML <pre> 元素和日志方法 log()。

<pre id="log"></pre>
const logElement = document.getElementById("log");
function log(text) {
  logElement.innerText += `${text}\n`;
}

接下来,我们使用 "canParse" in URL 条件检查是否支持 URL.canParse() 方法。如果支持该方法,我们会记录检查绝对 URL、无基本 URL 的相对 URL 和有效基本 URL 的相对 URL 的结果。我们还记录了不支持 URL.canParse() 的情况。

if ("canParse" in URL) {
  log("测试有效绝对 URL");
  let url = "https://developer.mozilla.org/";
  let result = URL.canParse(url);
  log(` URL.canParse("${url}"): ${result}`);

  log("\n测试无基本 URL 的相对 URL");
  url = "/zh-CN/docs";
  result = URL.canParse(url);
  log(` URL.canParse("${url}"): ${result}`);

  log("\n测试具有有效基本 URL 的相对 URL");
  let baseUrl = "https://developer.mozilla.org/";
  result = URL.canParse(url, baseUrl);
  log(` URL.canParse("${url}","${baseUrl}"): ${result}`);
} else {
  log("不支持 URL.canParse()");
}

最后,下面的代码表明,baseUrl 不一定是字符串。这里我们传递的是一个 URL 对象。

if ("canParse" in URL) {
  log("\n测试以 URL 对象为基本 URL 的相对 URL");
  let baseUrl = new URL("https://developer.mozilla.org/");
  let url = "/zh-CN/docs";
  result = URL.canParse(url, baseUrl);
  log(` URL.canParse("${url}","${baseUrl}"): ${result}`);
}

各项检查结果如下。

示例

规范

浏览器兼容性

参见

来源:MDN Web Docs / Mozilla 贡献者 · 作者与贡献记录 · CC BY-SA 2.5。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
MDN Web Docs / Mozilla 贡献者
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY-SA 2.5

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。