Object built-in object

Object UrlObject

Url processing object

base module. supplyurlFormatting, 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 relationship

#lineWidth: 1.5 #font: Helvetica,sans-Serif #fontSize: 10 #leading: 1.6 #.this: fill=lightgray #.class: fill=white [<class>object|toString();toJSON()] [<this>UrlObject|new UrlObject()|href;protocol;slashes;auth;username;password;host;hostname;port;path;pathname;search;query;hash;searchParams|parse();format();resolve();normalize()] [object] <:- [UrlObject] UrlObject new UrlObject() href protocol slashes auth username password host hostname port path pathname search query hash searchParams parse() format() resolve() normalize() object toString() toJSON()

Constructor

UrlObject

UrlObject object constructor, constructed with parameters

1
new UrlObject(Object args);

Call parameters:

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

UrlObject object constructor, useurlString construction

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

Call parameters:

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

Member properties

href

String, query and set the complete value in the current UrlObject objecturlAddress description, which 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 authentication 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 hastname and port

1
String UrlObject.host;

hostname

String, query and set the hostname 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 full path of the request (including the request) in the current UrlObject object, assembled from 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 (without "?")

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 aurlstring

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

Call parameters:

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

format

Constructs a UrlObject with the specified parameters

1
UrlObject.format(Object args);

Call parameters:

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

resolve

reseturlPath, automatically identify whether the new path is a relative path or an absolute path

1
UrlObject UrlObject.resolve(String url);

Call parameters:

  • url: String, specifies the new path

Return result:

  • UrlObject, returns an object containing the 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 the string representation of the object

toJSON

Returns the JSON format representation of the object, generally returns the set of readable properties defined by the object

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

Call parameters:

  • key: String, unused

Return result:

  • Value, returns a value containing JSON serializable