百度360必应搜狗淘宝本站头条
当前位置:网站首页 > 技术文章 > 正文

在JavaScript中使用URL API

myzbx 2025-01-01 21:41 11 浏览

URL是Web应用的关键部分。所有现代浏览器都支持URLAPI,它提供了一种解析和操作URL的方法。提供了对URL各个部分的访问。

了解URL的组成部分

考虑以下URL:

https://example.com/api/search?query=foo&sort=asc#results

URL由以下组件组成:

  • Protocol:https
  • Host:example.com
  • Path name:/api/search
  • Query string:?query=foo&sort=asc
  • Hash:#results

使用现代JavaScript,我们可以解析URL并根据需要提取这些不同的部分。

解析URL

URLAPI可用之前,开发人员解析URL的一种方法是使用 <a> 元素。这个元素提供了一些基本的URL解析。例如,这里有一种方法可以从URL中查询字符串:

function getQueryString(url) {
  const link = document.createElement('a');
  link.href = url;
  return url.search;
}

然而,这种方法有一些缺点:

  • 它需要DOM环境,这意味着它不能在Node.js这样的环境中工作
  • 它也没有错误处理--如果向href属性传递了无效的URL,则不会抛出错误

您也可以使用正则表达式来解析URL的各个部分,但这很繁琐且容易出错。

使用URLAPI来解析URL非常简单。只需将您想要解析的URL传递给URL构造函数。如果URL字符串是有效的,您将返回一个URL对象,其中包含URL各个部分的属性:

const url = new URL('https://example.com/api/search?query=foobar');
console.log(url.host); // example.com
console.log(url.pathname); // /api/search
console.log(url.search); // ?query=foobar

解析查询字符串

您可以通过两种方式访问URL的字符串:

  • search属性,它是一个完整查询字符串(包括 字符)
  • searchParams属性,它是URLSearchParams对象

如果你对查询字符串中某个特定参数的值感兴趣,你可以使用它的get方法获取该参数:

const url = new URL('https://example.com/api/search?query=foobar&maxResults=10');
console.log(url.searchParams.get('query'); // foobar
console.log(url.searchParams.get('maxResults'); // 10

如果有多个参数具有相同的名称,可以使用getAll获取一个所有包含该名称的数组:

const url = new URL('https://example.com/api/search?tag=tag1&tag=tag2&tag=tag3');
console.log(url.searchParams.getAll('tag')); // ['tag1', 'tag2', 'tag3']

生成查询字符串

手动构建查询字符串可能比较棘手,尤其是当查询参数包含需要转义的特殊字符时。例如,如果查询参数包含一个特殊字符,则需要将其编码为%26 。为了解决这些问题,你需要使用encodeURIComponent函数:

let queryString = 'foo=bar';
queryString += '&baz=qux';
queryString += '&tag=' + encodeURIComponent('one&two');
console.log(queryString); // foo=bar&baz=qux&tag=one%26two

您可以使用URLSearchParams对象更安全地构建查询字符串:

const params = new URLSearchParams();
params.append('foo', 'bar');
params.append('baz', 'qux');
params.append('tag', 'one&two');
console.log(params.toString()); // foo=bar&baz=qux&tag=one%26two

使用URLSearchParams的优点包括:

  • 您不必担心分隔参数的特殊字符
  • 不需要对参数值进行URI编码
  • 您不需要使用字符串连接

遍历查询参数

如果没有URLSearchParams对象,那么在字符串中遍历参数就有点棘手。你需要多次拆分字符串。

function listQueryParams(queryString) {
  queryString.split('&').forEach(param => {
    const [key, value] = param.split('=');
    console.log(`${key}: ${value}`);
  });
}

如果参数包含编码字符,则还需要对它们进行解码:

function listQueryParams(queryString) {
  queryString.split('&').forEach(param => {
    const [key, value] = param.split('=');
    console.log(`${key}: ${decodeURIComponent(value)}`);
  });
}

相反,您可以使用URLSearchParamsentries方法来遍历键/值对:

function listQueryParams(queryString) {
  const params = new URLSearchParams(queryString);
  params.entries().forEach(([key, value]) => console.log(`${key}: ${value}`));
}

创建完整的URL

下面是一个使用基本URL参数构建URL的完整示例:

const url = new URL('https://example.com/api/search');
url.searchParams.append('query', 'test');
url.searchParams.append('tag', 'tag1');
url.searchParams.append('tag', 'tag2');

// https://example.com/api/search?query=test&tag=tag1&tag=tag2
console.log(url.toString());

检查有效的URL

您可以使用URLAPI。如果你给它一个无效的URL,URL构造函数将抛出一个错误。

function isValidURL(url) {
  try {
    new URL(url);
    return true;
  } catch (error) {
    return false;
  }
}

使用较新的浏览器,这甚至更容易。新的URL.canParse静态方法,与上面的isValidURL函数类似。它接受一个URL字符串,并根据URL字符串的有效性,返回truefalse

创建相对URL

URLAPI有一个强大的机制来解析相对URL。通常,如果URL构造函数的参数不是完整、有效的URL,则会抛出错误。但是,您可以指定第二个参数,作为构建相对URL的基础。第一个参数不必是有效的URL,但第二个参数必须是有效的URL。

我们先来看一个简单的案例:

new URL('/about', 'https://example.com').href;

URL构造函数采用https://example.com的基URL,并添加相对路径/about ,得到https://example.com/about

这个呢?

new URL('profile', 'https://example.com/users').href;

您可能认为这是 https://example.com/users/profile ,但实际上它是https://example.com/profile 。它的行为就像一个相对链接; 它采用父路径段,即example的根.com ,然后添加profile

在 window.location工作

new URL('/profile', window.location).href;

使用URLPattern匹配URL中的模式

使用URL可以很容易地从URL获取路径。例如,在URLhttps://example.com/api/users/123/profile 中,路径名为 /API/users/123/profile 。如果我们只想从这个URL中获取用户ID 123 呢?

const pattern = new URLPattern('https://example.com/api/users/:userId/profile');
const matcher = pattern.exec('https://example.com/api/users/123/profile');
console.log(matcher.pathname.groups.userId); // 123

当您在URLPattern上调用exec时,它需要一个有效的URL。它返回一个匹配器对象,其中包含URL的每个部分( 协议主机路径名 等)的属性。这些属性中的每一个都有一个groups属性,它将占位符名称(如 :userId )映射到URL中的值。

URLPatternAPI仍然不能在所有浏览器中使用。在撰写本文时,Firefox或Safari还不支持它。您可以在CanIUse.com上查看最新的浏览器支持信息。

相关推荐

攀升战境S5电竞主机评测:NVIDIA RTX 3060实力助阵,光追游戏走起

此次笔者将为玩家们推荐一款游戏主机——攀升战境S5。该主机是攀升电脑今年力推的游戏装备,主机采用一线品牌配件,特别是在显卡选用上严苛把关,精选GeForceRTX30系列显卡,玩家们大可以放心选购...

慎买-神牛闪光灯兼容性问题:神牛V350&amp;松下S5M2

神牛V350和松下S5M2的兼容性问题。大家好,我是向往闪光灯人像的Fish。国庆期间,我购买了神牛V350闪光灯和神牛X2T引闪器,但这成为了我的噩梦。我原以为客服和松友们说这款闪光灯在松下S5M2...

Acer蜂鸟持续办公一整天(acer 蜂鸟s5)

移动办公在工作节奏日益加快的今天越来越普遍,目前大部分工作无法在手持设备上完成,笔记本依然是移动办公最明智的选择。为了实现移动办公,很多笔记本越做越轻薄,性能也越来越强,而续航却一直没有很大提升。笔者...

职业车手明年会骑什么?2021赛季各大世巡赛车队使用器材一览

新年的钟声即将敲响,意味着充满魔幻色彩的2020年即将过去。受新冠肺炎的影响,2020年的赛季非常不同寻常。因这一原因不得不延迟举行的各种比赛导致许多车队的赞助商无法得到足够曝光,这也间接导致了许多车...

三星部分手机系统升级路线图流出(三星系统在哪升级)

三星包括Note3和S5在内的手机在升级到4.4.2系统之后一直没有什么系统升级的消息,而最近流出的一张三星的系统升级路线图中出现了一共13台手机升级KTU84P(也就是Android4.4.4)...

索尼Xperia Z3配置大曝光:升级并不大

IT之家(www.ithome.com):索尼XperiaZ3配置大曝光:升级并不大索尼明天就会在IFA2014大会上发布其下代旗舰XperiaZ3智能手机,目前网上曝光了其原型机,并且机身背后...

不进反退 三星Exynos 5433只能运行32位模式?

三星GalaxyNote4将带有两个版本,除了国行使用的骁龙805以外,还有三星自家的Exynos5433版本。而这颗SoC的详细信息三星并没有公布,据外媒Anandtech称,他们从源码中确认...

尼康Z6III测评:对比EOS R6 II、A7M4、S5IIX

摄影器材测评网站DPReview刚刚发布了尼康Z6III的完整图文测评,该机获得金奖评级,得分达到91%。以下是该文章的摘录——尼康Z6III核心规格:2400万像素“部分堆栈式”传感器RAW连拍:机...

赛默飞Ion S5首批数据公布,玩爆前任PGMTM系列

北美时间9月1日,赛默飞发布了两款最新的NGS系统IonS5和IonS5XL,旨在提供更加简捷的靶向测序流程。10月29日IonS5测序仪的首批实验数据产生于阜外医院。阜外医院研究人员选用了主...

Excel技巧:快速制作批量文件夹,省时省力,加强工作效率

大家好,如果公司领导要求按人员姓名制作文件夹,以一人一档的形式呈现人员档案,办公人员一个一个制作费时费力,而且效力低下,今天为大家介绍快捷制作批量文件夹的方法下面我们用图片来进行演示操作打开表格,选...

国行、港版、美版Apple watch各版本售价一览

今天凌晨,苹果牌手表正式发布,苹果开始正式进入可穿戴设备领域,除了功能和外观,我相信大家更关心的是价格问题了,小编就将国行、港版、美版的Applewatch售价做一总结,以供参考。国行:美版:港版:...

松下全画幅微单S5和S1到底哪里不一样?

Hello,我是ET,欢迎大家来到我的“相机笔记”。————9月2日晚,松下正式发布了第4款全画幅微单LUMIXS5。这一篇,我们主要来说松下LUMIXS5和LUMIXS1到底有哪些区别...

融会贯通之典范 神舟S7-2021S5评测

便携、性能、续航,这简简单单的六个字道出了这么些年来笔记本电脑的设计方向,可是由于底层技术、模具设计等等原因,这三点并不能很好的融合在一起。虽说闻道有先后,术业有专攻,但能够有一台融会贯通的产品,不是...

三国志战略版:S5赛季装X指南,开荒不是一成不变,需要因地制宜

大家好我是零氪玩家花席,S5赛季已经开始,因为S5赛季的野地阵容和S4赛季没有区别,所以S5赛季开荒相对不难。你在S4有经验,并且多了很多武将和战法,还能用150赛季功勋兑换7500战法点。S5赛季新...

聊聊松下S5M2和S5M2X的区别(松下s5k和s5c有什么区别)

先简单说下哪里不同:12bitRAWHDMI外录支持直接将视频录制到USB-SSD上多了All-Intra和ProRes编码支持有线/无线IP推流,USB网络连接黑化的机身不过要特别强调一下,S5...