About

jquery-ajax-localstorage-cache is a plugin built for jQuery (>1.5.1) and localStorage. It's a fork of a fork from the jStorage-dependent original. It provides a client-side cache AJAX responses intended to save bandwith and time.

How to use

Parameters

	$.ajax({
		url               : '/post',
		localCache        : true,         // required to use
		cacheTTL          : 1,            // in hours. Optional
		cacheKey          : 'post',       // optional
		preventExpiration : true,         // optional
		isCacheValid      : function(){   // optional
			return true;
		},

		success: function(reply) {
			// i can play with my reply ! 
		}
	});

On your AJAX request you get 5 new parameters :

• localCache
  • Turn localCache on/off
  • Default: false
• cacheTTL
  • time in hours the entry should be valid.
  • only for this specific ajax request
  • Default : 5 hours
• cacheKey
  • CacheKey is the key that will be used to store the response in localStorage. It allow you to delete your cache easily with the localStorage.removeItem() function.
  • Default: URL + TYPE(GET/POST) + DATA
• preventExpiration
  • Prevents expiration of the data, regardless of the TTL.
  • Default: false
• isCacheValid
  • This function must return true or false. On false, the cached response is removed.
  • Default: null

Notes

• You can delete the cache by using localStorage.clear().
• Note that you can pre-load content with this plugin. You just have do to the same AJAX request without a success callback and the same cacheKey.

License

This project is distributed under Apache 2 License. See LICENSE.txt for more information.