node中的url常用方法解析

url字符串是一個結構化的字符串,由好幾個有意義部分組成。我們在工作中不可避免的會用到其中的某個部分,最原始的通過字符串截取和正則匹配的方法難免用起來會不太方便和美觀,所以在我們的nodejs中提供了一個處理和解析url的模塊url,該模塊提供了一些實用的函數(shù)使我們解析起來更加的方便快捷,那接下里我們來分析一下它提供的常用的函數(shù)的用法

url模塊提供了兩套API來處理URLs:
一個是Node.js遺留的特有的API,

保留的原因:雖然Node.js遺留的特有的API并沒有被棄用,但是保留的目的是用于向后兼容已有應用程序。因此新的應用程序請使用WHATWG API。

另一個則是通常使用在web瀏覽器中 實現(xiàn)了WHATWG URL Standard的API.該API是在node8.0.0中正式應用的

在瀏覽器中,WHATWG URL在全局總是可用的,而在Node.js中,任何情況下打開 或使用一個鏈接都必須事先引用'url'模塊:require('url').URL

const url = require('url');
首先我們先來看看這個模塊中都有哪些方法?
let http = require('http');
let url = require('url');
console.log(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] }
接下來我們挨個來講解上面這些方法的用法
let {parse, resolve, format, URL, URLSearchParams, domainToASCII, domainToUnicode} = require('url');
1、parse(urlStr,queryString,AnalysisHost)

Node.js遺留的特有的API
參數(shù):

urlStr: 要解析的url地址
queryString: 解析出來的查詢字符串還是查詢對象,true是對象 false是字符串,例如:http://foo/bar?a=123, true的話 query: {a: 123}, false的話 query: 'a=123' 默認是false
AnalysisHost: 是否要解析出來host (即將//之后至下一個/之前的字符串),例如://foo/bar 會被解析為{host: 'foo', pathname: '/bar},否則{pathname: '//foo/bar'}.默認是false

作用:解析url,返回一個url屬性對象

例如:

const myURLA =
    url.parse('https://user:pass@sub.host.com:8080/p/a/t/h?query=string#hash', true);
console.log(myURLA);

// Url {
//     protocol: 'https:', // 協(xié)議
//         slashes: true,
//         auth: 'user:pass', // 用戶名密碼
//         host: 'sub.host.com:8080', // host主機名
//         port: '8080', // 端口號
//         hostname: 'sub.host.com', // 主機名不帶端口號
//         hash: '#hash', // 哈希值
//         search: '?query=string',// 查詢字符串
//         query: 'query=string', // 請求參數(shù)
//         pathname: '/p/a/t/h', // 路徑名
//         path: '/p/a/t/h?query=string', // 帶查詢的路徑名
//         href: 'https://user:pass@sub.host.com:8080/p/a/t/h?query=string#hash' // 原字符串本身
}

錯誤:

如果urlStr不是字符串將會拋出TypeError。

const myurl = url.parse({a:123});
TypeError: Parameter "url" must be a string, not object

如果auth屬性存在但無法編碼則拋出URIError。

2、resolve(from, to)

參數(shù):

from: 解析時對應的基本的url
to:要解析的超鏈接url

作用:以一種 Web 瀏覽器解析超鏈接的方式把一個目標 URL 解析成相對于一個基礎 URL。

例如:

const url = require('url');
url.resolve('/one/two/three', 'four');         // '/one/two/four'
url.resolve('http://example.com/', '/one');    // 'http://example.com/one'
url.resolve('http://example.com/one', '/two'); // 'http://example.com/two'
3、format(url,options)

參數(shù):

url: 一個WHATWG URL對象
options:
1. auth: 如果序列化的URL字符串應該包含用戶名和密碼為true,否則為false。默認為true。
2. fragment: 如果序列化的URL字符串應該包含分段為true,否則為false。默認為true。即是不是需要包含哈希值
3. search: 如果序列化的URL字符串應該包含搜索查詢?yōu)閠rue,否則為false。默認為true。
4. unicode: true 如果出現(xiàn)在URL字符串主機元素里的Unicode字符應該被直接編碼而不是使用Punycode編碼為true,默認為false。
返回一個WHATWG URL對象的可自定義序列化的URL字符串表達。

雖然URL對象的toString()方法和href屬性都可以返回URL的序列化的字符串。然而,兩者都不可以被自定義。而url.format(URL[, options])方法允許輸出的基本自定義。

例如:

const { URL } = require('url');
const myURL = new URL('https://a:b@你好你好?abc#foo');

console.log(myURL.href);
  // 輸出 https://a:b@xn--6qqa088eba/?abc#foo

console.log(myURL.toString());
  // 輸出 https://a:b@xn--6qqa088eba/?abc#foo

console.log(url.format(myURL, { fragment: false, unicode: true, auth: false }));
  // 輸出 'https://你好你好/?abc'
4、new URL(input[, base])

瀏覽器兼容的 URL 類,根據(jù) WHATWG URL 標準實現(xiàn)。

注意: 根據(jù)瀏覽器的約定,URL 對象的所有屬性都是在類的原型上實現(xiàn)為getter和setter,而不是作為對象本身的數(shù)據(jù)屬性。因此,與[遺留的urlObjects][]不同,在 URL 對象的任何屬性(例如 delete myURL.protocol,delete myURL.pathname等)上使用 delete 關鍵字沒有任何效果,但仍返回 true。

參數(shù):

input: 解析的輸入url
base: 如果“input”是相對url,則為要解析的基本url

作用:通過將input解析到base上創(chuàng)建一個新的URL對象。如果base是一個字符串,則解析方法與new URL(base)相同。

例如:

const { URL } = require('url');
const myURL = new URL('/foo', 'https://example.org/');
  // https://example.org/foo

如果input或base是無效URLs,將會拋出TypeError。請注意給定值將被強制轉換為字符串。例如:

const { URL } = require('url');
const myURL = new URL({ toString: () => 'https://example.org/' });
  // https://example.org/

存在于input主機名中的Unicode字符將被使用Punycode算法自動轉換為ASCII。

const { URL } = require('url');
const myURL = new URL('https://你好你好');
  // https://xn--6qqa088eba/
5.URLSearchParams

URLSearchParamsAPI接口提供對URLquery部分的讀寫權限。URLSearchParams類也能夠與以下四個構造函數(shù)中的任意一個單獨使用。

例如:

const { URL, URLSearchParams } = require('url');

const myURL = new URL('https://example.org/?abc=123');
console.log(myURL.searchParams.get('abc'));
// 輸出 123

myURL.searchParams.append('abc', 'xyz');
console.log(myURL.href);
// 輸出 https://example.org/?abc=123&abc=xyz

myURL.searchParams.delete('abc');
myURL.searchParams.set('a', 'b');
console.log(myURL.href);
// 輸出 https://example.org/?a=b

const newSearchParams = new URLSearchParams(myURL.searchParams);
// 上面的代碼等同于
// const newSearchParams = new URLSearchParams(myURL.search);

newSearchParams.append('a', 'c');
console.log(myURL.href);
// 輸出 https://example.org/?a=b
console.log(newSearchParams.toString());
// 輸出 a=b&a=c

// newSearchParams.toString() 被隱式調用
myURL.search = newSearchParams;
console.log(myURL.href);
// 輸出 https://example.org/?a=b&a=c
newSearchParams.delete('a');
console.log(myURL.href);
// 輸出 https://example.org/?a=b&a=c
6、domainToASCII(domain)

返回Punycode ASCII序列化的domain. 如果domain是無效域名,將返回空字符串。
它執(zhí)行的是url.domainToUnicode()的逆運算。

const url = require('url');
console.log(url.domainToASCII('espa?ol.com'));
  // 輸出 xn--espaol-zwa.com
console.log(url.domainToASCII('中文.com'));
  // 輸出 xn--fiq228c.com
console.log(url.domainToASCII('xn--i?valid.com'));
  // 輸出空字符串
7. domainToUnicode(domain)

返回Unicode序列化的domain. 如果domain是無效域名,將返回空字符串。

它執(zhí)行的是url.domainToASCII()的逆運算。

const url = require('url');
console.log(url.domainToUnicode('xn--espaol-zwa.com'));
  // 輸出 espa?ol.com
console.log(url.domainToUnicode('xn--fiq228c.com'));
  // 輸出 中文.com
console.log(url.domainToUnicode('xn--i?valid.com'));
  // 輸出空字符串
?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成,瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明:文章內容(如有圖片或視頻亦包括在內)由作者上傳并發(fā)布,文章內容僅代表作者本人觀點,簡書系信息發(fā)布平臺,僅提供信息存儲服務。

相關閱讀更多精彩內容

  • Spring Cloud為開發(fā)人員提供了快速構建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,506評論 19 139
  • 1. Java基礎部分 基礎部分的順序:基本語法,類相關的語法,內部類的語法,繼承相關的語法,異常的語法,線程的語...
    子非魚_t_閱讀 34,626評論 18 399
  • 人生,總是在反反復復中度過。 從記事起到現(xiàn)在的二十多年中,總會因為一些事做的不好而責怪自己,覺的自己應該去努力,去...
    一縷清風閱讀 338評論 0 0
  • 在使用 Objective-C 開發(fā)過程中,在一個頭文件里面引入另一個頭文件是一件正常不過的事情,不過這里面也有一...
    要上班的斌哥閱讀 2,480評論 0 3
  • 工作領悟 一、不必急于反駁或者爭辯,你要做的就是以行動替代回答。
    柒捌月閱讀 105評論 0 0

友情鏈接更多精彩內容