parseUri

Steven Levithan Oct 24, 2008

General

This function splits any well-formed URI into its parts (all are optional). All parts are split with a single regex using backreferences, and all groupings which don't contain complete URI parts are non-capturing.

Try the demonstration

Notes

Created by: Steven Levithan
Web Site: stevenlevithan.com
Posted: October 24, 2008

Highlights

Comprehensively splits URIs, including splitting the query string into key/value pairs.
Two parsing modes: loose and strict.
Offers convenient, pre-concatenated components (path = directory and file; authority = userInfo, host, and port; etc.)
Change the default names of URI parts without editing the function, by updating parseUri.options.key.

Blog post

Details

Source Code

Paste this source code into the designated areas.

External file

Paste this code into an external JavaScript file named: parseuri.js

/* This script and many more are available free online at
The JavaScript Source!! http://www.javascriptsource.com
Created by: Steven Levithan | stevenlevithan.comLicensed under: MIT License
 */

function parseUri (str) {
	var	o   = parseUri.options,
		m   = o.parser[o.strictMode ? "strict" : "loose"].exec(str),
		uri = {},
		i   = 14;

	while (i--) uri[o.key[i]] = m[i] || "";

	uri[o.q.name] = {};
	uri[o.key[12]].replace(o.q.parser, function ($0, $1, $2) {
		if ($1) uri[o.q.name][$1] = $2;
	});

	return uri;
};

parseUri.options = {
	strictMode: false,
	key: ["source","protocol","authority","userInfo","user","password","host","port","relative","path","directory","file","query","anchor"],
	q:   {
		name:   "queryKey",
		parser: /(?:^|&)([^&=]*)=?([^&]*)/g
	},
	parser: {
		strict: /^(?:([^:\/?#]+):)?(?:\/\/((?:(([^:@]*):?([^:@]*))?@)?([^:\/?#]*)(?::(\d*))?))?((((?:[^?#\/]*\/)*)([^?#]*))(?:\?([^#]*))?(?:#(.*))?)/,
		loose:  /^(?:(?![^:@]+:[^:@\/]*@)([^:\/?#.]+):)?(?:\/\/)?((?:(([^:@]*):?([^:@]*))?@)?([^:\/?#]*)(?::(\d*))?)(((\/(?:[^?#](?![^?#\/]*\.[^?#\/.]+(?:[?#]|$)))*\/?)?([^?#\/]*))(?:\?([^#]*))?(?:#(.*))?)/
	}
};

Head

Paste this code into the HEAD section of your HTML document.


<script type="text/javascript" src="parseuri.js"></script>

Leave a Response

(0 comments)

Alphabetical Listing

Tutorials

Ajax Tutorials

Ajax

Buttons

Cookies

CSS

Forms

Games

Generators

Image Effects

Math Related

Miscellaneous

Multimedia

Navigation

Page Details

Password

Snippets

Text Effects

Time & Date

User Details