Object built-in object

Object UrlObject

Url processing object

Basic module. provideurl Formatting, parsing and assembling

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

#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, using parameter construction

1
new UrlObject(Object args);

Call parameters:

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

UrlObject object constructor, use url String construction

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

Call parameters:

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

Member attributes

href

String, query and set the integrity of the current UrlObject object url Address description, this description is assembled from all other attributes

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 by the username and password attributes

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 by 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 full 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, which is 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 point 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 one url String

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

Call parameters:

  • url: String, specify what needs to be parsed url String
  • parseQueryString: Boolean, specify whether to parse the query
  • slashesDenoteHost: Boolean, default is false, if set to true, the string from after the string'//' to the next'/' will be parsed as 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, the dictionary object that specifies the construction parameters. The supported fields are: protocol, slashes, username, password, hostname, port, pathname, query, hash

resolve

reset url Path, automatically recognize whether the new path is a relative path or an absolute path

1
UrlObject UrlObject.resolve(String url);

Call parameters:

  • url: String, specify a new path

Return result:

  • UrlObject, Returns an 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 re-implemented 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 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