Kanso package for a browser compatible version of the node.js url module
JavaScript
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
README.md
kanso.json
url.js

README.md

URL Module

Adapted for use in the browser and packaged for Kanso by Caolan McMahon. This build does not include IDNA Support in order to avoid the punycode dependency.

Installation

Add url to your dependencies section in kanso.json.

  ...
  "dependencies": {
    "url": null,
    ...
  }

run kanso install to fetch the package

URL objects

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

'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'
  • href: The full URL that was originally parsed. Both the protocol and host are lowercased. Example: 'http://user:pass@host.com:8080/p/a/t/h?query=string#hash'

  • protocol: The request protocol, lowercased. Example: 'http:'

  • host: The full lowercased host portion of the URL, including port and authentication information. Example: 'user:pass@host.com:8080'

  • auth: The authentication information portion of a URL. Example: 'user:pass'

  • hostname: Just the lowercased hostname portion of the host. Example: 'host.com'

  • port: The port number portion of the host. Example: '8080'

  • pathname: The path section of the URL, that comes after the host and before the query, including the initial slash if present. Example: '/p/a/t/h'

  • search: The 'query string' portion of the URL, including the leading question mark. Example: '?query=string'

  • path: Concatenation of pathname and search. Example: '/p/a/t/h?query=string'

  • query: Either the 'params' portion of the query string, or a querystring-parsed object. Example: 'query=string' or {'query':'string'}

  • hash: The 'fragment' portion of the URL including the pound-sign. Example: '#hash'

API

url.parse(urlStr, [parseQueryString], [slashesDenoteHost])

Take a URL string, and return an object.

Pass true as the second argument to also parse the query string using the querystring module. Defaults to false.

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

url.format(urlObj)

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

  • href will be ignored.
  • protocol is treated the same with or without the trailing : (colon).
    • The protocols http, https, ftp, gopher, file will be postfixed with :// (colon-slash-slash).
    • All other protocols mailto, xmpp, aim, sftp, foo, etc will be postfixed with : (colon)
  • auth will only be used if host is absent.
  • hostname will only be used if host is absent.
  • port will only be used if host is absent.
  • host will be used in place of auth, hostname, and port
  • pathname is treated the same with or without the leading / (slash)
  • search will be used in place of query
  • query (object; see querystring) will only be used if search is absent.
  • search is treated the same with or without the leading ? (question mark)
  • hash is treated the same with or without the leading # (pound sign, anchor)

url.resolve(from, to)

Take a base URL, and a href URL, and resolve them as a browser would for an anchor tag.