Object built-in object

Object UrlObject

Url processing object

Basic module. Provide url formatting, parsing and assembly

1 2 3 4 5 6
var url = new net.Url('http://www.xici.net/'); var url = new net.Url({ protocol: 'http:', hostname: 'www.xici.net', pathname: '/' });

Inheritance

Constructor

UrlObject

UrlObject object constructor, constructed using parameters

1
new UrlObject(Object args);

Call parameters:

  • args : Object, a dictionary object that specifies the construction parameters. The supported fields are: protocol, slashes, username, password, hostname, port, pathname, query, hash

UrlObject object constructor, using url string construction

1 2 3
new UrlObject(String url = "", Boolean parseQueryString = false, Boolean slashesDenoteHost = false);

Call parameters:

  • url : String, specify to construct url string
  • parseQueryString : Boolean, specifies whether to parse the query
  • slashesDenoteHost : Boolean, default is false, if set to true, then the string from the string'//' to the next'/' will be parsed as a host, for example'//foo/bar', the result should be {host:'foo', pathname:'/bar'} instead of {pathname:'//foo/bar'}

Member attribute

href

String, query and set the complete url address description in the current UrlObject object, this description is assembled from all other properties

1
String UrlObject.href;

protocol

String, query and set the protocol name in the current UrlObject object

1
String UrlObject.protocol;

slashes

Boolean, query and set whether the current UrlObject object contains double slashes

1
Boolean UrlObject.slashes;

auth

String, query and set the complete verification string in the current UrlObject object, assembled from the username and password properties

1
String UrlObject.auth;

username

String, query and set the authenticated user in the current UrlObject object

1
String UrlObject.username;

password

String, query and set the authentication password in the current UrlObject object

1
String UrlObject.password;

host

String, query and set the complete host description in the current UrlObject object, assembled from hasname and port

1
String UrlObject.host;

hostname

String, query and set the host name in the current UrlObject object

1
String UrlObject.hostname;

port

String, query and set the port number in the current UrlObject object

1
String UrlObject.port;

path

String, query and set the complete path of the request in the current UrlObject object (including the request), assembled by pathname and query

1
String UrlObject.path;

pathname

String, query and set the path in the current UrlObject object

1
String UrlObject.pathname;

String, query and set the request string (including "?") in the current UrlObject object, equivalent to "?"+query

1
String UrlObject.search;

query

Value, query and set the request string in the current UrlObject object (excluding "?")

1
Value UrlObject.query;

hash

String, query and set the request anchor in the current UrlObject object (including "#")

1
String UrlObject.hash;

searchParams

HttpCollection , query the request string in the current UrlObject object (without "?")

1
readonly HttpCollection UrlObject.searchParams;

Member function

parse

Parse a url string

1 2 3
UrlObject.parse(String url, Boolean parseQueryString = false, Boolean slashesDenoteHost = false);

Call parameters:

  • url : String, specifies the url string to be parsed
  • parseQueryString : Boolean, specifies whether to parse the query
  • slashesDenoteHost : Boolean, default is false, if set to true, then the string from the string'//' to the next'/' will be parsed as a host, for example'//foo/bar', the result should be {host:'foo', pathname:'/bar'} instead of {pathname:'//foo/bar'}

format

Construct UrlObject with specified parameters

1
UrlObject.format(Object args);

Call parameters:

  • args : Object, a dictionary object that specifies the construction parameters. The supported fields are: protocol, slashes, username, password, hostname, port, pathname, query, hash

resolve

url path, automatically identify whether the new path is relative or absolute

1
UrlObject UrlObject.resolve(String url);

Call parameters:

  • url : String, specify a new path

Return result:

  • UrlObject , return object containing relocation data

normalize

Standardized path

1
UrlObject.normalize();

toString

Returns the string representation of the object, generally returns "[Native Object]", the object can be reimplemented according to its own characteristics

1
String UrlObject.toString();

Return result:

  • String , returns a string representation of the object

toJSON

Returns the JSON representation of the object, generally returns a collection of readable attributes defined by the object

1
Value UrlObject.toJSON(String key = "");

Call parameters:

  • key : String, unused

Return result:

  • Value , returns a value containing JSON serializable