Skip to content
Super Tiny JSONP Library
JavaScript HTML

README.md

JSONP Beta 1.0

Alpha Stage

What

This is a super tiny JSONP library for when you don't need jQuery or another JS library just for JSONP requests.

Why

After searching for "JSONP examples" and "JSONP tutorials" I was dissapointed by the lack of straightforward JSONP stuff out there. While there is nothing wrong with jQuery and I use it every single day, sometimes you need to do some JSONP without using jQuery and so I wrote this for myself, but feel free to use it! The min version is only 621 bytes.

How

The high-level signature for the function looks like this:

JSONP([uri], [data], [custom_method_name], [callback])
  • uri - simply specify the endpoint you want to call. [string]
  • data - the payload that you want to include in your request. [object]
  • custom_method_name - this controls the name of the function that will make the JSONP request. Optionally used in certain cases. [string]
  • callback - a function called on a succesful response. [function]

To get my Twitter avatar for example you'd do:

JSONP('http://twitter.com/users/oscargodson.json',function(json){
  console.log(json.profile_image_url);
});

Sometimes the third-party site require a custom method name, like Flickr, which requires jsoncallback rather than the standard callback method. Here's an example to get a thumbnail of my latest pic on Flickr:

JSONP('http://api.flickr.com/services/feeds/photos_public.gne?id=12389944@N03&format=json','jsoncallback',function(json){
  console.log(json.items[0].media.m);
});

You can also pass parameters in the form of a JSON object, like so:

JSONP('https://api.github.com/users/carvefx/gists',{'since': '2014-02-01T12:00:00Z'},function(json){
  document.getElementById('github').innerHTML = json.data[0].html_url;
});

Browser Support

  • IE6+
  • Firefox 3.0+
  • Safari 4.0+
  • Google Chrome 14.0+
  • Opera 10.6+

To do...

  • Anything else people request, if anything
Something went wrong with that request. Please try again.