讲师中心 微信公众号
AI工具推荐 视频效率加速

Javascript的URL API是什么_怎样用Javascript解析和操作URL?

冬瑶酱_1891

冬瑶酱_1891

发布时间:2026-01-03 21:03:08

|

161人浏览过

|

来源于php中文网

原创

URL API 是浏览器和 Node.js(v10.0.0+)原生支持的标准 URL 解析工具,需传入绝对 URL 或配合 base 参数使用;其属性只读,query 操作应通过 URLSearchParams,修改路径或协议须新建实例,并注意对不可信输入做 try/catch 和协议校验。

javascript的url api是什么_怎样用javascript解析和操作url?

URL API 是浏览器原生支持的 URL 解析工具,不是第三方库

它从 ES2015(ES6)起就内置在现代浏览器中,无需 import 或安装。Node.js 从 v10.0.0 开始也支持(需注意版本),但早期版本或某些运行时(如 Deno、某些打包环境)可能不完全兼容。它的核心价值是:用标准、可靠、无正则风险的方式拆解和组装 URL。

new URL() 构造函数必须传入完整 URL 字符串

常见错误是直接传入相对路径或不带协议的字符串,比如 new URL("/api/user?id=1") 会抛出 TypeError: Invalid URL。它需要一个可解析的绝对 URL,或配合 base 参数使用:

  • ✅ 正确:new URL("https://example.com/api/user?id=1")
  • ✅ 正确(带 base):new URL("/api/user?id=1", "https://example.com")
  • ❌ 错误:new URL("/api/user?id=1")(缺少 base,报错)
  • ❌ 错误:new URL("api/user")(既不绝对也不合法相对)

构造后返回的对象有多个只读属性:hreforiginprotocolusernamepasswordhostnameportpathnamesearchhash —— 这些都是字符串,不能直接赋值修改。

URLSearchParams 处理 query string 最安全

search 属性只是字符串(如 "?a=1&b=2"),真正解析和操作参数要用 URLSearchParams。它比手写正则或 split("&") 更健壮,自动处理编码/解码:

立即学习Java免费学习笔记(深入)”;

douyin-keyword-search
douyin-keyword-search

自动化抓取抖音搜索结果页面的文章数据,支持关键词搜索、格式输出和数量限制,需安装Playwright和Chromium浏览器。

下载
const url = new URL("https://example.com/?name=%E4%BD%A0%E5%A5%BD&city=Shanghai");
const params = url.searchParams;

console.log(params.get("name")); // "你好"
console.log(params.has("city")); // true
params.set("age", "25");
params.append("tag", "js");
console.log(url.href); // "https://example.com/?name=%E4%BD%A0%E5%A5%BD&city=Shanghai&age=25&tag=js"

注意:url.searchParams 是实时绑定的 —— 修改它会自动更新 url.hrefurl.search;但它不响应式更新原始字符串变量,只影响该 URL 实例。

修改 URL 要靠重新赋值,不是直接改属性

URL 对象的属性全是只读的,想改路径、协议或参数,必须通过 searchParams 或拼接新字符串再构造新实例:

  • 改 query:用 url.searchParams.set() 等方法(推荐)
  • 改 pathname:只能新建实例,如 new URL("/new/path" + url.search, url.origin)
  • 改 protocol/host:同上,new URL(url.toString().replace(/^http:/, "https:")) 不可靠,应显式重组

别试图写 url.pathname = "/new" —— 这不会生效,也不会报错,只是静默忽略。

真正容易被忽略的是:URL API 不处理 URL 编码异常(比如未闭合的 %XX)、不校验域名格式、也不做网络请求验证。它只做结构解析。如果你拿到的 URL 来自用户输入或不可信来源,先 try/catch 包裹 new URL(),再检查 url.protocol 是否为 "http:""https:",避免 javascript:data: 类型引发意外行为。

热门AI工具

更多
DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

VibeKnow
VibeKnow Hot

一款AI视频创作工具,主要用于全球首个AI知识视频创作平台,文档、文章、网页,一键生成视频,适合需要提升相关任务效率的用户。

UpDream
UpDream Hot

一款AI视频创作工具,主要用于哔哩哔哩推出的自研AI视频创作工具,适合需要提升相关任务效率的用户。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

相关专题

更多
es6新特性
es6新特性

es6新特性有:1、块级作用域变量;2、箭头函数;3、模板字符串;4、解构赋值;5、默认参数;6、 扩展运算符;7、 类和继承;8、Promise。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

265

2023.07.17

es6新特性有哪些
es6新特性有哪些

es6的新特性有:1、块级作用域;2、箭头函数;3、解构赋值;4、默认参数;5、扩展运算符;6、模板字符串;7、类和模块;8、迭代器和生成器;9、Promise对象;10、模块化导入和导出等等。本专题为大家提供es6新特性的相关的文章、下载、课程内容,供大家免费下载体验。

386

2023.08.04

JavaScript ES6新特性
JavaScript ES6新特性

ES6是JavaScript的根本性升级,引入let/const实现块级作用域、箭头函数解决this绑定问题、解构赋值与模板字符串简化数据处理、对象简写与模块化提升代码可读性与组织性。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

335

2025.12.24

string转int
string转int

在编程中,我们经常会遇到需要将字符串(str)转换为整数(int)的情况。这可能是因为我们需要对字符串进行数值计算,或者需要将用户输入的字符串转换为整数进行处理。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

5139

2023.08.02

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

1538

2023.08.03

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2204

2023.09.04

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

5724

2023.10.24

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

4749

2023.11.24

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

0

2026.09.23

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WebStorm 官方调试文档
WebStorm 官方调试文档

共0课时 | 0人学习

React 教程
React 教程

共58课时 | 11.9万人学习

TypeScript 教程
TypeScript 教程

共19课时 | 6.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn