url · Magic_sword2

[TOC] # 简介说明 原文链接： - [url](https://github.com/nodejs/node/blob/main/doc/api/url.md) ``` 版本：url 作用：url 模块用于处理与解析 URL ``` # url # *parse() ***** 解析url返回URL对象 # *domainToASCII() ***** 返回 Punycode ASCII 序列化的 domain。如果 domain 是无效域名，则返回空字符串 # *domainToUnicode() ***** 返回 Unicode 序列化的 domain。如果 domain 是无效域名，则返回空字符串。 # *fileURLToPath() ***** URL转换成文件路径 # *format() ***** 自定义解析格式，通过参数设置 # *pathToFileURL() ***** 此函数可确保 path 会被解析为绝对路径，并在转换为文件 URL 时正确编码 URL 控制字符。 # *resolve() ***** 拼合路径返回绝对的URL路径 # url.URL # [new]-URL() ***** 浏览器兼容的 URL 类，根据 WHATWG URL 标准实现 ### 参数说明 input: * 类型：字符串 * 默认值：无 * 描述：要解析的绝对或相对的 URL * 可选值：[ ] base: * 类型：字符串 * 默认值：无 * 描述：如果 input 不是绝对路径，则为要解析的基本 URL * 可选值：[ ] ### 示例内容 1. 举例说明 ``` ┌────────────────────────────────────────────────────────────────────────────────────────────────┐ │ href │ ├──────────┬──┬─────────────────────┬────────────────────────┬───────────────────────────┬───────┤ │ protocol │ │ auth │ host │ path │ hash │ │ │ │ ├─────────────────┬──────┼──────────┬────────────────┤ │ │ │ │ │ hostname │ port │ pathname │ search │ │ │ │ │ │ │ │ ├─┬──────────────┤ │ │ │ │ │ │ │ │ │ query │ │ " https: // user : pass @ sub.example.com : 8080 /p/a/t/h ? query=string #hash " │ │ │ │ │ hostname │ port │ │ │ │ │ │ │ │ ├─────────────────┴──────┤ │ │ │ │ protocol │ │ username │ password │ host │ │ │ │ ├──────────┴──┼──────────┴──────────┼────────────────────────┤ │ │ │ │ origin │ │ origin │ pathname │ search │ hash │ ├─────────────┴─────────────────────┴────────────────────────┴──────────┴────────────────┴───────┤ │ href │ └────────────────────────────────────────────────────────────────────────────────────────────────┘ ``` # hash ***** 获取及设置 URL 的片段部分 # host ***** 获取及设置 URL 的主机部分 # hostname ***** 获取及设置 URL 的主机名部分。 url.host 和 url.hostname 之间的区别是 url.hostname 不包含端口 # href ***** 获取及设置序列化的 URL # origin ***** 获取只读的序列化的 URL 的 origin # password ***** 获取及设置 URL 的密码部分 # pathname ***** 获取及设置 URL 的路径部分。 # port ***** 获取及设置 URL 的端口部分。 # protocol ***** 获取及设置 URL 的协议部分 # search ***** 获取及设置 URL 的序列化查询部分 # searchParams ***** 获取表示 URL 查询参数的 URLSearchParams 对象 ### 返回类型 ``` URLSearchParams ``` # username ***** 获取及设置 URL 的用户名部分 # toString() ***** 在 URL 对象上调用 toString() 方法将返回序列化的 URL # toJSON() ***** URL 对象上调用 toJSON() 方法将返回序列化的 URL # url.URLSearchParams # [new]-URLSearchParams() ***** 提供对 URL 查询部分的读写权限，和 querystring 模块有相似的目的 # append() ***** 在查询字符串中附加一个新的键值对 # delete() ***** 删除所有键为name的键值对。 # entries() ***** 在查询中的每个键值对上返回一个 ES6 Iterator # forEach() ***** 在查询字符串中迭代每个键值对，并调用给定的函数 # get() ***** 返回键是name的第一个键值对的值。如果没有对应的键值对，则返回null。 # getAll() ***** 返回键是name的所有键值对的值，如果没有满足条件的键值对，则返回一个空的数组。 # has() ***** 如果存在至少一对键是 name 的键值对则返回 true。 # keys() ***** 在每一个键值对上返回一个键的 ES6 Iterator。 # set() ***** 将 URLSearchParams 对象中与 name 相对应的值设置为 value # sort() ***** 按现有名称就地排列所有的名称-值对 # toString() ***** 返回查询参数序列化后的字符串，必要时存在百分号编码字符。 # values() ***** 在每一个键值对上返回一个值的 ES6 Iterator。