CR.URL

From Market Ruler Help
Revision as of 00:59, 2 July 2020 by Admin (talk | contribs)
Jump to: navigation, search

The __CR.URL function is a JavaScript function that parses the current URL. It returns a newly created URL object representing the URL defined by the parameters.

Using __CR.URL()

When you call __CR.URL() it parses the current URL and the following structure is returned (data is included as part of this example).

   {protocol: "https", host: "addresslock.com", path: "/", hash: "", query: "", …}
  • protocol: indicates which protocol the browser must use; typically for websites, it is "http" or "https" (a web page which is secured between your browser and the server).
  • host: returns the current domain; indicates which web server is being requested.
  • path: the path to the resource, starts with "/".
  • query: starts with "?", indicates parameters provided to the web server; parameters are listed in key/value pairs (using the "=" symbol) and then separated by the "&" symbol.
  • hash: anchor or fragment identifier, begins with "#"; it is an optional part of a URL that gives the browser directions to content at a "bookmarked" spot.
  • port: indicated by ":" and a number. It is the technical 'gate' used to access the resources on the web server. Port is usually omitted if the web server uses the standard ports of the HTTP protocol (80 for HTTP and 443 for HTTPS).

Note the changes that occur when you update query parameters in the following example using addresslock.com:

> __CR.URL()
 {"protocol":"https","host":"addresslock.com","path":"/","hash":"","query":"","port":443,"url":"https://addresslock.com/","queryparams":{}}
> __CR.URL()
 {"protocol":"https","host":"addresslock.com","path":"/","hash":"","query":"test=abc&Test=123","port":443,"url":"https://addresslock.com/?test=abc&Test=123","queryParams":{"test":"abc","Test":"123"},"queryparams":{"test":"123"}}
> __CR.URL()
 {"protocol":"https","host":"addresslock.com","path":"/","hash":"hash","query":"","port":443,"url":"https://addresslock.com/#hash","queryparams":{}}

See also