53

Looking for a way to parse key pairs out of the hash/fragment of a URL into an object/associative array with JavaScript/JQuery

Yarin
  • 159,198
  • 144
  • 384
  • 498

10 Answers10

54

Here it is, modified from this query string parser:

function getHashParams() {

    var hashParams = {};
    var e,
        a = /\+/g,  // Regex for replacing addition symbol with a space
        r = /([^&;=]+)=?([^&;]*)/g,
        d = function (s) { return decodeURIComponent(s.replace(a, " ")); },
        q = window.location.hash.substring(1);

    while (e = r.exec(q))
       hashParams[d(e[1])] = d(e[2]);

    return hashParams;
}

No JQuery/plug-in required

Update:

I'm now recommending the jQuery BBQ plugin as per Hovis's answer. It covers all hash parsing issues.

Update (2019)

Apparently there is now a URLSearchParams function - see answer from @Berkant

Yarin
  • 159,198
  • 144
  • 384
  • 498
  • 9
    could you elaborate on the "hash parsing issues"? I have the same need and I don't see anything wrong with your answer. – Christophe Oct 11 '12 at 21:03
  • @Christophe- I honestly can't recall. I'm sure my code works fine, but BBQ is a total plugin with hashchange events, query string parsing, etc, so probably that's what I meant.. – Yarin Sep 12 '13 at 16:31
  • 2
    For basic handling your script is awesome!! Too often we default to jQuery libraries for basic tasks. Thanks! – SomethingOn Feb 07 '14 at 15:46
  • What does a semicolon do in the `r` regexp? – Gebb Nov 29 '17 at 09:53
  • Jquery BBQ is no longer being updated and has issues with the latest JQuery. – crthompson Oct 19 '18 at 18:55
40

Use URLSearchParams. Browser coverage: https://caniuse.com/urlsearchparams. It's fully supported in major browsers. Here is a polyfill if you need to use this on unsupported browsers.

To read a simple key:

// window.location.hash = "#any_hash_key=any_value"

const parsedHash = new URLSearchParams(
  window.location.hash.substring(1) // skip the first char (#)
);

console.log(parsedHash.get("any_hash_key")); // any_value

Check out the Mozilla docs I linked above to see all of the methods of the interface.

Berkant Ipek
  • 892
  • 11
  • 17
30

Check out: jQuery BBQ

jQuery BBQ is designed for parsing things from the url (query string or fragment), and goes a bit farther to simplify fragment-based history. This is the jQuery plugin Yarin was looking for before he put together a pure js solution. Specifically, the deparam.fragment() function does the job. Have a look!

(The support site I'm working on uses an asynchronous search, and because BBQ makes it trivial to tuck entire objects into the fragment I use it to 'persist' my search parameters. This gives my users history states for their searches, and also allows them to bookmark useful searches. Best of all, when QA finds a search defect they can link straight to the problematic results!)

Yarin
  • 159,198
  • 144
  • 384
  • 498
Hovis Biddle
  • 871
  • 8
  • 14
  • @Hovis- this is indeed an awesome plugin, and in fact I've switched over to using it as well. Giving you the answer as it's a much better option than my scratch function. – Yarin Nov 30 '11 at 21:35
  • I'm going to start using this. – The Muffin Man Dec 17 '11 at 19:02
  • 6
    BBQ doesn't work well with Jquery 1.9+ and throws exceptions on load. It hasn't been updated in over three years. I'm not sure BBQ is still a good recommendation. You may be able to hack it to get it to work, see this: https://github.com/cowboy/jquery-bbq/pull/41 – nostromo Oct 21 '13 at 07:05
22

Do this in pure Javascript:

var hash = window.location.hash.substr(1);

var result = hash.split('&').reduce(function (result, item) {
    var parts = item.split('=');
    result[parts[0]] = parts[1];
    return result;
}, {});

http://example.com/#from=2012-01-05&to=2013-01-01

becomes

{from: '2012-01-05', to:'2013-01-01'}

crthompson
  • 15,265
  • 6
  • 55
  • 78
  • This does not handle decoding, for example `#this=is+a+test` the plus signs should be convert to spaces... and there are a dozen other special cases. It is crazy to try to implement this yourself. It is such a common problem. – John Henckel Aug 19 '20 at 18:52
  • 1
    i retract the 'crazy to try...' comment! trying to implement something is a great way to learn. Despite being 3 yrs old, this is still a common question, and downvoting is how we curate the knowledge. At the moment your answer is rated *higher* than the one about `URLSearchParams` which is the issue i was trying to fix by downvoting. – John Henckel Aug 20 '20 at 13:30
  • @JohnHenckel, if you need url decoding, just add a line to do url decoding. The reason why this has been such a popular answer is that it doesnt use other libraries. Also, its had several years to get to this level. Given time, the others will to. No need to be petty, upvote what you like, let others do the same. ;) – crthompson Mar 27 '22 at 16:39
3

I am using jQuery URL Parser library.

serg
  • 106,723
  • 76
  • 306
  • 327
2

I was looking through a bunch of answers for this problem and wound up cobbling them together using one line with reduce:

const hashObj = location.hash.replace('#', '').split('&').reduce((prev, item) => Object.assign({[item.split('=')[0]]: item.split('=')[1]}, prev), {});

There's obviously a lot going on in that one line. It can be rewritten like this for clariry:

const hashObj = location.hash.replace('#', '').split('&').reduce((prev, item) => {
  return Object.assign({[item.split('=')[0]]: item.split('=')[1]}, prev);
}, {});
mccambridge
  • 965
  • 7
  • 16
0

You can also use the .hash property, demonstrated in this scrolling table of contents example for a clicked link or for the locatioin.

Community
  • 1
  • 1
yuvilio
  • 3,385
  • 31
  • 33
0

This jquery API does parse hash tags: https://jhash.codeplex.com/

// get the "name" querystring value
var n = jHash.val('name');

// get the "location" querystring value
var l = jHash.val('location');

// set some querystring values
jHash.val({
    name: 'Chris',
    location: 'WI'
});
SomeoneElse
  • 476
  • 1
  • 5
  • 22
0

My answer to this question should do what you're looking for:

url_args_decode = function (url) {
  var args_enc, el, i, nameval, ret;
  ret = {};
  // use the DOM to parse the URL via an 'a' element
  el = document.createElement("a");
  el.href = url;
  // strip off initial ? on search and split
  args_enc = el.search.substring(1).split('&');
  for (i = 0; i < args_enc.length; i++) {
    // convert + into space, split on =, and then decode 
    args_enc[i].replace(/\+/g, ' ');
    nameval = args_enc[i].split('=', 2);
    ret[decodeURIComponent(nameval[0])]=decodeURIComponent(nameval[1]);
  }
  return ret;
};
Community
  • 1
  • 1
BMitch
  • 188,157
  • 34
  • 411
  • 383
-2

You might want to check out jsuri. It seems to work well for me.

gatoatigrado
  • 16,288
  • 15
  • 79
  • 141