tiny-url.js - URL Object for tinyJS

tiny-url.js adds the function t.u to tiny, which can convert an URL-String to an Objekt similar to location, with some added value.

Download

tiny-url.js [1655b] - tiny-url-min.js.gz [508b]

Hint

The t.u-Method requires only tiny.js. Other scripts are not necessary.

Usage

The function t.u('[URL]') returns an Object with helpful instances and the Method .toString(). The instances are as follows:

Instances

href	Full URL
protocol	URL-Protocol, e.g. 'http:'
hostname	Hostname (FQDN), e.g. 'tinyjs.sourceforge.net'
base	'//'+hostname
port	Port of the TCP connection (if not :80), e.g. 8080
pathname	path including filename, e.g. '/index-en.html'
search	GET-Parameters-String with prefixing '?', e.g. '?test=true'
hash	Hash-Parameter of an page-internal link
params	An Object with all GET-Parameters

If called without parameters, t.u() uses location.href as URL. Within the function, the instances of location.href are available (including params), so t.u().hostname === t.u.hostname.

toString()-Method

The URL Object has a toString-Method, which is somewhat different from usual toString. It takes zero or one Arguments. Without arguments, it returns an absolute URL, if the first argument is false, it returns a relative URL. If the first argument is an URL, it returns an absolute URL using the argument as base.

Example

href	"https://tinyjs.sourceforge.net/tiny-url-en.html"
protocol	"https:"
hostname	"tinyjs.sourceforge.net"
base	"//tinyjs.sourceforge.net"
port
pathname	"/tiny-url-en.html"
search
hash
params	{}

Code

t('#example td').i(function(k, v) {
    if (t.u[v.id]) { v.innerHTML = JSON.stringify(t.u[v.id]); }
});