https://github.com/OscarGodson/JSONP

Super Tiny JSONP Library
https://github.com/OscarGodson/JSONP

Last synced: about 2 months ago
JSON representation

Super Tiny JSONP Library

• Host: GitHub
• URL: https://github.com/OscarGodson/JSONP
• Owner: OscarGodson
• License: mit
• Created: 2011-05-17T09:34:04.000Z (over 13 years ago)
• Default Branch: master
• Last Pushed: 2019-03-09T09:33:39.000Z (over 5 years ago)
• Last Synced: 2024-05-08T14:32:20.905Z (5 months ago)
• Language: JavaScript
• Homepage:
• Size: 11.7 KB
• Stars: 86
• Watchers: 7
• Forks: 28
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: license.txt

Awesome Lists containing this project

README

        
# 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