title: '前端开发系列088-Node篇之url'
tags:
- Node系列
categories: []
date: 2018-09-25 23:20:13
本文对Node的内置模块url进行介绍,包括基本情况和简单使用。
一、模块的内容
url是Node的内置核心模块之一,无需单独安装可以直接在代码中通过var url = require("url")
的方式加载,该模块提供了很多使用的函数专门用于URL的处理和解析。
在命令行环境中可以直接通过REPL来查看URL模块的内容,这个模块本身返回一个对象。
URL模块中有三个比较重要的方法
parse方法
用于将URL字符串转换为对象format方法
用于将特定的对象还原为URL字符串resolve方法
用于将两个(字符串 base url对象和href url对象)路径合成一个路径。
bogon:~ wendingding$ node
> console.dir(url);
{ Url: [Function: Url],
parse: [Function: urlParse],
resolve: [Function: urlResolve],
resolveObject: [Function: urlResolveObject],
format: [Function: urlFormat],
URL: [Function: URL],
URLSearchParams: [Function: URLSearchParams],
domainToASCII: [Function: domainToASCII],
domainToUnicode: [Function: domainToUnicode] }
URL的结构
Node内置的url模块提供了两套API来处理URL字符串
- Node.js特有的API,是旧版本的遗留;
- 实现了WHATWG URL Standard的API ,该标准也在各种浏览器中被使用。
![](http://img.wendingding.vip/blog/node_url.png)
上图给出的是两套API的结构比较情况。其中网址上方是Node API中的的url.parse()方法
解析后返回的对象结构,网址下方的则是WHATWG URL对象的结构,在具体使用的时候需要注意区分。
使用示例:
//WHATWG URL Standard API
const { URL } = require('url');
const myURL =
new URL('https://user:[email protected]:8080/p/a/t/h?query=string#hash');
//Node API
const url = require('url');
const myURL =
url.parse('https://user:[email protected]:8080/p/a/t/h?query=string#hash');
二、基本使用
这里主要介绍URL模块中常用方法的基本使用、这些方法的作用、参数传递以及返回值结构等情况,并提供简短的代码示例。
parse方法
作用 解析URL字符串并返回URL对象。
语法 url.parse( urlStr , [ parseQueryString ] , [ slashesDenoteHost ])
参数
- urlStr 字符串类型 | 待解析的 URL 字符串
- parseQueryString 布尔值类型 | 是否把查询字符串转换为对象。
- slashesDenoteHost 布尔值类型 | 是否把`//后...下一个/之前`的字符串会解析为host。
返回值
- 解析成功 URL对象。
- 解析失败 报错(若参数非字符串抛出`TypeError`|若无法编码抛出`URIError`) 。
示例
wendingding$ node
url.parse("https://user:[email protected]:8080/p/a/t/h?query=string#hash")
Url {
protocol: 'https:',
slashes: true,
auth: 'user:pass',
host: 'www.wendingding.com:8080',
port: '8080',
hostname: 'www.wendingding.com',
hash: '#hash',
search: '?query=string',
query: 'query=string',
pathname: '/p/a/t/h',
path: '/p/a/t/h?query=string',
href: 'https://user:[email protected]:8080/p/a/t/h?query=string#hash'
}
URL对象字段说明
href 被转换的原URL字符串。
protocol 请求使用的协议。
auth URL字符串中的认证信息。
host URL字符串中的完整地址和端口号。
port URL字符串中的端口号。
slashes 协议和路径中间是否使用//分隔符。
hostname URL字符串中的完整地址(`主机名`|`IP地址`)。
hash URL字符串中的散列字符串,包含起始字符`#`。
search URL字符串中的查询字符串,包含起始字符`?`。
path URL字符串中的路径,包含查询字符串。
pathname URL字符串中的路径,不包含查询字符串。
query 查询字符串(如果parseQueryString参数传递true,则保存为对象)。
示例
wendingding$ node
>var obj = url.parse("https://www.wendingding.com/doc?name=mitaoer&password=931007",true)
undefined
>obj
Url {
protocol: 'https:',
slashes: true,
auth: null,
host: 'www.wendingding.com',
port: null,
hostname: 'www.wendingding.com',
hash: null,
search: '?name=mitaoer&password=931007',
query: { name: 'mitaoer', password: '931007' },
pathname: '/doc',
path: '/doc?name=mitaoer&password=931007',
href: 'https://www.wendingding.com/doc?name=mitaoer&password=931007' }
> obj.query
{ name: 'mitaoer', password: '931007' }
format方法
作用 把URL对象转换(序列化)为URL字符串。
语法 url.format( url , [ options ])
参数
- url [WHATWG URL](http://nodejs.cn/api/url.html#url_the_whatwg_url_api)类型的对象。
- options 对象类型 | 用于控制转换(序列化)的配置。
返回值 如果解析成功,那么就返回对应的URL字符串。
obj
Url {
protocol: 'https:',
slashes: true,
auth: null,
host: 'www.wendingding.com',
port: null,
hostname: 'www.wendingding.com',
hash: null,
search: '?name=mitaoer&password=931007',
query: { name: 'mitaoer', password: '931007' },
pathname: '/doc',
path: '/doc?name=mitaoer&password=931007',
href: 'https://www.wendingding.com/doc?name=mitaoer&password=931007' }
> obj.query
{ name: 'mitaoer', password: '931007' }
> var urlStr = url.format(obj)
> urlStr
'https://www.wendingding.com/doc?name=mitaoer&password=931007'
备注 该方法第二个参数Options参数是可选的接受一个配置对象,可以配置下面列出的四个字段它们都是布尔类型的值,如果不配置那么默认均为true。
search 是否应该包含搜索查询。
auth 是否应该包含用户名和密码。
fragment 结果字符串是否应该包含分段。
unicode Unicode字符是否应该被直接编码。
resolve方法
作用 同浏览器那样把URL转换为完整的目标地址。
语法 url.resolve( from , to )
参数
- from 字符串类型 | 解析时相对的基本 URL(起点路径)
- to 字符串类型 | 要解析的超链接的 URL(参考路径)。
示例
> url.resolve('/one/two/three', 'four');
'/one/two/four'
> url.resolve('http://www.wendingding.com/', '/one');
'http://www.wendingding.com/one'
> url.resolve('http://www.wendingding.com/one', '/two');
'http://www.wendingding.com/two'
标签:Node,www,088,url,URL,wendingding,字符串,com
From: https://www.cnblogs.com/wendingding/p/16986496.html