{ "source": "url.markdown", "modules": [ { "textRaw": "URL", "name": "url", "desc": "
稳定度: 3 - 稳定
\n

This module has utilities for URL resolution and parsing.\nCall require('url') to use it.\n\n

\n

该模块包含用以 URL 解析的实用函数。\n使用 require('url') 来调用该模块。\n\n

\n

Parsed URL objects have some or all of the following fields, depending on\nwhether or not they exist in the URL string. Any parts that are not in the URL\nstring will not be in the parsed object. Examples are shown for the URL\n\n

\n

不同的 URL 字符串解析后返回的对象会有一些额外的字段信息，仅当该部分出现在 URL 中才会有。以下是一个 URL 例子：\n\n

\n

'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'\n\n

\n

'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'\n\n

\n\n

The following methods are provided by the URL module:\n\n

\n

以下是 URL 模块提供的方法：\n\n

\n", "methods": [ { "textRaw": "url.parse(urlStr, [parseQueryString], [slashesDenoteHost])", "type": "method", "name": "parse", "desc": "

Take a URL string, and return an object.\n\n

\n

输入 URL 字符串，返回一个对象。\n\n

\n

Pass true as the second argument to also parse\nthe query string using the querystring module.\nDefaults to false.\n\n

\n

将第二个参数设置为 true 则使用 querystring 模块来解析 URL 中德查询字符串部分，默认为 false。\n\n

\n

Pass true as the third argument to treat //foo/bar as\n{ host: 'foo', pathname: '/bar' } rather than\n{ pathname: '//foo/bar' }. Defaults to false.\n\n

\n

将第三个参数设置为 true 来把诸如 //foo/bar 这样的URL解析为\n{ host: 'foo', pathname: '/bar' } 而不是\n{ pathname: '//foo/bar' }。 默认为 false。\n\n

\n", "signatures": [ { "params": [ { "name": "urlStr" }, { "name": "parseQueryString", "optional": true }, { "name": "slashesDenoteHost", "optional": true } ] } ] }, { "textRaw": "url.format(urlObj)", "type": "method", "name": "format", "desc": "

Take a parsed URL object, and return a formatted URL string.\n\n

\n

输入一个 URL 对象，返回格式化后的 URL 字符串。\n\n

\n\n", "signatures": [ { "params": [ { "name": "urlObj" } ] } ] }, { "textRaw": "url.resolve(from, to)", "type": "method", "name": "resolve", "desc": "

Take a base URL, and a href URL, and resolve them as a browser would for\nan anchor tag. Examples:\n\n

\n

给定一个基础URL路径，和一个href URL路径，并且象浏览器那样处理他们可以带上锚点。 例子：\n\n

\n
url.resolve('/one/two/three', 'four')         // '/one/two/four'\nurl.resolve('http://example.com/', '/one')    // 'http://example.com/one'\nurl.resolve('http://example.com/one', '/two') // 'http://example.com/two'\n\n\nurl.resolve('/one/two/three', 'four')         // '/one/two/four'\nurl.resolve('http://example.com/', '/one')    // 'http://example.com/one'\nurl.resolve('http://example.com/one', '/two') // 'http://example.com/two'
\n", "signatures": [ { "params": [ { "name": "from" }, { "name": "to" } ] } ] } ], "type": "module", "displayName": "URL" } ] }