/jsapi-info

Publically configurable, centralised store of JS libs' API source code

Primary LanguageJavaScript

JSAPI.info

A JS library source inspector. Libraries are specified in libs.json, e.g.

{
	"jquery": {
		"url": "https://ajax.googleapis.com/ajax/libs/jquery/{VERSION}/jquery.js",
		"default_version": "1.6.4",
		"versions": ["1", "1.1", "1.2", "1.3", "1.3.2", "1.4", "1.5", "1.6", "1.6.2", "1.6.4"],
		"get_real_version": "v(\\d+\\.\\d+\\.\\d+)",
		"look_in": ["jQuery.fn", "jQuery"],
		"mutate_names": [
			["^\\$(?=\\.)", "jQuery"],
			["^jQuery\\.prototype", "jQuery.fn"]
		]
	} // ,...
}

Given the above configuration, we can now access /jquery/[VERSION/]METHOD_NAME in our browser. JSAPI.info will only source the jQuery source file remotely (from googleapis) if it hasn't already cached it locally.

THIS IS STILL UNDER DEVELOPMENT: Live @ jsapi.info.

How does it work?

It works by loading the library you specify into an instance of jsdom, and then evaluating the method you specify (in fully qualified form, e.g. jQuery.fn.css) within that instance. It then matches the toString() representation of that function (thanks V8!!) against the source of the library, thus determining its location. It's all operating under node.js, running via a beautiful configuration of nginx (primed to microcache!) on a linode box somewhere in London.

Installation / Running it

  1. cd jsapi-info/app
  2. npm install .
  3. node server 8001
  4. Server should be running on :8001

Changelog

  • 1.0.0 - Gotta start somewhere
  • 1.1.0 - Add package.json to manage dependencies. Linkifies this.methodName calls with new LINK_MARKER syntax (incl. name of item, e.g. this.css, and the full name, e.g. jQuery.fn.css). Sorts methods in sidebar by similarity to current method name (done with similarity.js).
  • 1.1.1 - Fixed ?expand option so it doesn't go beyond the end of the source file. Fixed issue where names present in global scope, even if not functions, take precedence in resolver, e.g. window.outerHeight when querying /jquery/outerHeight. Fixed this by including a typeof v == 'function' check in the embedded resolver function. Also fixed error being thrown when a method can't be found.
  • 1.1.2 - Added jQueryUI to libs and added a require option in the JSON config (currently only used with jQuery UI). Also generalised SHLoader.