☰

Greasy Fork is available in English.

WM Common Library

A collection of useful functions and objects, some of which are specific to the Wall Manager family of scripts.

Este script no debería instalarse directamente. Es una biblioteca que utilizan otros scripts mediante la meta-directiva de inclusión // @require https://update.greatest.deepsurf.us/scripts/765/2185/WM%20Common%20Library.js 

  1. // ==UserScript==
  2. // @name           	WM Common Library
  3. // @namespace  pt wm common library
  4. // @description	A collection of useful functions and objects, some of which are specific to the Wall Manager family of scripts.
  5. // @license		http://creativecommons.org/licenses/by-nc-nd/3.0/us/
  6. // @version        	3.0.1.10
  7. // @copyright       Charlie Ewing except where noted
  8. // ==/UserScript==
  9.  
  10. (function(){
  11. var sandbox=this;
  12.  
  13. //***************************************************************************************************************************************
  14. //***** Greasemonkey and Browser Type Validation
  15. //***************************************************************************************************************************************
  16.  
  17. // is Greasemonkey running
  18. sandbox.isGM = (typeof GM_getValue != 'undefined' && typeof GM_getValue('a', 'b') != 'undefined');
  19. sandbox.isChrome = navigator.userAgent.toLowerCase().indexOf('chrome') > -1;
  20.  
  21. //***************************************************************************************************************************************
  22. //***** Global Enumerated Values
  23. //***************************************************************************************************************************************
  24.  
  25. //enumerated string equal to script that does nothing
  26. sandbox.jsVoid="javascript:void(0)";
  27.  
  28. //time enums
  29. sandbox.second=1000;
  30. sandbox.minute=second*60;
  31. sandbox.hour=minute*60;
  32. sandbox.day=hour*24;
  33.  
  34. //***************************************************************************************************************************************
  35. //***** Data Type Verification
  36. //***************************************************************************************************************************************
  37.  
  38. //return true if o is undefined
  39. sandbox.isUndefined=function(o){try{return ((typeof o)=="undefined");}catch(e){log("wmLibrary.isUndefined: "+e);}};
  40.  
  41. //return true if o is a string
  42. sandbox.isString=function(o){try{return ((typeof o)=="string");}catch(e){log("wmLibrary.isString: "+e);}};
  43.  
  44. //return true if o is not undefined
  45. sandbox.exists=function(o){try{return (!isUndefined(o));}catch(e){log("wmLibrary.exists: "+e);}};
  46.  
  47. // Returns true if object o is an array
  48. sandbox.isArray=function(o){try{return (o instanceof Array);}catch(e){log("wmLibrary.isArray: "+e);}};
  49.  
  50. // Returns true if object o is an array and has a length > 0
  51. sandbox.isArrayAndNotEmpty=function(o){try{return isArray(o) && o.length>0;}catch(e){log("wmLibrary.isArrayAndNotEmpty: "+e);}};
  52.  
  53. // Returns true if object o is an object but not an array
  54. sandbox.isObject=function(o){try{return (((typeof o)=="object") && !isArray(o));}catch(e){log("wmLibrary.isObject: "+e);}};
  55.  
  56. //return true if o is undefined
  57. //sandbox.isNaN=function(o){try{return (o.toString()==="NaN");}catch(e){log("wmLibrary.isNaN: "+e);}};
  58.  
  59. //return integer value of object
  60. sandbox.val=function(o){try{return parseInt(o);}catch(e){log("wmLibrary.val: "+e);}};
  61.  
  62. sandbox.calcTime=function(timer) {try{
  63.  
  64. 	if ((typeof timer)=="integer") return timer;
  65. 	
  66. 	if (timer.match(/^(\d)/)) return val(timer);
  67.  
  68. 	//debug.print(timer);
  69. 	var t=2; //defaults to 2 minutes on error
  70. 	//check for U:# time format (u = millisecond count)
  71. 	if (timer.toLowerCase().startsWith("u:")) {
  72. 		t=parseInt(timer.toLowerCase().split("u:")[1]||"");
  73. 		return t;
  74. 	} 
  75. 	
  76. 	//check for s:# (s = second count)
  77. 	if (timer.toLowerCase().startsWith("s:")) {
  78. 		t=parseInt(timer.toLowerCase().split("s:")[1]||"")||0;
  79. 		return t*1000;
  80. 	} 
  81. 	
  82. 	//check for t:#D:#H:#M:#S time format
  83. 	if (timer.toLowerCase().startsWith("t:")){
  84. 		var fnNumberFromHMSDate = function(i,l) {
  85. 			var teststring = "(\\d)*?"+l;
  86. 			var test = new RegExp(teststring,"i");
  87. 			var testret = test.exec(i);
  88. 			//debug.print([i,teststring,testret]);
  89. 			return parseInt((testret||["0"])[0]);
  90. 		};
  91. 		t=timer.toLowerCase().split("t:")[1];
  92. 		//it should now be in "1d:2h:5m:30s" format
  93. 		var d = fnNumberFromHMSDate(t,"d");
  94. 		var h = fnNumberFromHMSDate(t,"h");
  95. 		var m = fnNumberFromHMSDate(t,"m");
  96. 		var s = fnNumberFromHMSDate(t,"s");
  97. 		//debug.print([d,h,m,s]);
  98. 		
  99. 		return ((s*second)+(m*minute)+(h*hour)+(d*day));
  100. 	}
  101. 	//do originally programmed time words
  102. 	
  103. 	switch(timer) {
  104. 		case "off": return 0; break; //off
  105. 		case "tenth": t = 0.1; break; // 6 seconds
  106. 		case "sixth": t = 0.1666667; break; // 10 seconds
  107. 		case "third": t = 0.3333333; break; // 20 seconds
  108. 		case "half": t = 0.5; break; // 30 seconds
  109. 		case "one": t = 1; break; // 1 minute
  110. 		case "two": t = 2; break; // 2 minutes
  111. 		case "three": t = 3; break; // 3 minutes
  112. 		case "four": t = 4; break; // 4 minutes
  113. 		case "five": t = 5; break; // 5 minutes
  114. 		case "ten": t = 10; break; // 10 minutes
  115. 		case "fifteen": t = 15; break; // 15 minutes
  116. 		case "thirty": t = 30; break; // 30 minutes
  117. 		case "hour": t = 60; break; // 1 hour
  118. 		case "2hour": t = 60*2; break; // 2 hours
  119. 		case "3hour": t = 60*3; break; // 3 hours
  120. 		case "4hour": t = 60*4; break; // 4 hours
  121. 		case "8hour": t = 60*8; break; // 8 hours
  122. 		case "12hour": t = 60*12; break; // 12 hours
  123. 		case "18hour": t = 60*18; break; // 18 hours
  124. 		case "24hour": t = 60*24; break; // 1 day
  125. 		case "36hour": t = 60*36; break; // 1.5 days
  126. 		case "48hour": t = 60*48; break; // 2 days
  127. 		case "30s2m": t = (Math.random() * 1.5) + 0.5; break; // random between 30s and 2m
  128. 		case "2m5m": t = (Math.random() * 3) + 2; break; // random between 2m and 5m
  129. 		case "5m10m": t = (Math.random() * 5) + 5; break; // random between 5m and 10m
  130. 	}
  131. 	return Math.round((t*60000)+(Math.random()*(t*100)));
  132. 	
  133. }catch(e){log("wmLibrary.calcTime: "+e);}};
  134.  
  135. //comprehensive convert anything to a boolean value
  136. sandbox.cBool = function(x){try{
  137. 	//log(x||"undefined");
  138. 	//capture undefined
  139. 	if (!exists(x)) return false;
  140. 	//capture nulls
  141. 	if (x==null) return false;
  142. 	//capture checkboxes
  143. 	if (exists(x.checked)) x=x.checked;
  144. 	//capture objects with value property
  145. 	if (exists(x.value)) x=x.value;
  146. 	//capture boolean values
  147. 	if ((typeof x)=="boolean") return x;
  148. 	//capture non-null objects
  149. 	if (isObject(x)) return true;
  150. 	//capture arrays
  151. 	if (isArray(x)) return true;
  152. 	//capture text
  153. 	if (typeof x=="string") {
  154. 		var trueVal=x;
  155. 		if (exists(x.toLowerCase)) trueVal=x.toLowerCase();
  156. 		switch(trueVal){
  157. 			case "1": case "true": case "yes": case "checked": return true; break;
  158. 			case "0": case "false": case "no": case "unchecked": return false; break;
  159. 		}
  160. 	}
  161. 	//default
  162. 	return Boolean(x);
  163. }catch(e){log("wmLibrary.cBool: {x="+x+"}: "+e);}};
  164.  
  165. //***************************************************************************************************************************************
  166. //***** Logging
  167. //***************************************************************************************************************************************
  168.  
  169. // cross-browser log function, turns the log variable into a function
  170. // originally from FVWM by Joe Simmons
  171. // now also catches the WM debug window first
  172. sandbox.log=function(){try{ 
  173. 	var fx, debug=this.debug;
  174. 	if (exists(debug)) fx=debug.print;
  175. 	else if (isGM) fx=GM_log;
  176. 	else if (window.opera) fx=opera.postError;
  177. 	else fx=console.log;
  178. 	if (fx) {var args=arguments, self=this; setTimeout(function(){fx.apply(self,args);},0); }
  179. }catch(e){console.log("WmLibrary.log: "+e);}};
  180.  
  181. //***************************************************************************************************************************************
  182. //***** Style Sheet Creation
  183. //***************************************************************************************************************************************
  184.  
  185. //append css style to the header
  186. //supply a name and this function will force that style sheet to have an id attribute equal to the name supplied
  187. //supply a doc object and the stylesheet will be put in that document instead of this one
  188. sandbox.addGlobalStyle=function(css,name,doc) {try{var head, style;head = (doc||document).getElementsByTagName('head')[0];if (!head) { return; };style = (doc||document).createElement('style');style.type = 'text/css';style.innerHTML = css;head.appendChild(style); if(name||null) style.setAttribute("id",name);}catch(e){log("wmLibrary.addGlobalStyle: "+e);}};
  189.  
  190. //***************************************************************************************************************************************
  191. //***** Mouse Events
  192. //***************************************************************************************************************************************
  193.  
  194. //click specified DOM element
  195. sandbox.click=function(e) {try{if(!e && typeof e=='string') e=document.getElementById(e);if(!e) return;var evObj = e.ownerDocument.createEvent('MouseEvents');evObj.initMouseEvent("click",true,true,e.ownerDocument.defaultView,0,0,0,0,0,false,false,false,false,0,null);e.dispatchEvent(evObj);}catch(e){log("wmLibrary.click: "+e);}};
  196.  
  197. //pretend to put the mouse over specified DOM element
  198. sandbox.mouseover=function(e) {try{if(!e && typeof e=='string') e=document.getElementById(e);if(!e) return;var evObj = e.ownerDocument.createEvent('MouseEvents');evObj.initMouseEvent("mouseover",true,true,e.ownerDocument.defaultView,0,0,0,0,0,false,false,false,false,0,null);e.dispatchEvent(evObj);}catch(e){log("wmLibrary.mouseover: "+e);}};
  199.  
  200. //***************************************************************************************************************************************
  201. //***** DOM Creation/Manipulation
  202. //***************************************************************************************************************************************
  203.  
  204. //return a DOM element by ID with optional alternate root document
  205. sandbox.$=function(ID,root) {try{return (root||document).getElementById(ID);}catch(e){log("wmLibrary.$: "+e);}};
  206.  
  207. //return new DOM element a, with parameters b, and children c
  208. sandbox.createElement=function(a,b,c) {try{
  209. 	if(a=="text") {return document.createTextNode(b);};
  210. 	var ret=document.createElement(a.toLowerCase());
  211. 	if(b) for(var prop in b) {
  212. 		if(prop.indexOf("on")==0) {
  213. 			ret.addEventListener(prop.substring(2),b[prop],false);
  214. 		} else if ( 
  215. 			",style,accesskey,id,name,src,href,which,rel,action,method,value,data-ft".indexOf(","+prop.toLowerCase())!=-1
  216. 		) {
  217. 			ret.setAttribute(prop.toLowerCase(), b[prop]);
  218. 		/*} else if (
  219. 			!exists(ret[prop.toLowerCase()])
  220. 		} {
  221. 			ret.setAttribute(prop.toLowerCase(), b[prop]);*/
  222. 		} else {
  223. 			ret[prop]=b[prop];
  224. 		}
  225. 	}
  226. 	if(c) c.forEach(
  227. 		function(e) { 
  228. 			if (e) ret.appendChild(e); 
  229. 		}
  230. 	);
  231. 	return ret;
  232. }catch(e){log("wmLibrary.createElement: "+e);}};
  233.  
  234. //return document.location.pathname
  235. sandbox.getDocName=function() {try{return document.location.pathname;}catch(e){log("wmLibrary.getDocName: "+e);}};
  236.  
  237. //remove specified DOM element
  238. sandbox.remove=function(e) {try{var node=(typeof e=='string')?$(e):e; if(node && node.parentNode) node.parentNode.removeChild(node); node=null;}catch(e){log("wmLibrary.remove: "+e);}};
  239.  
  240. //return selected nodes using xpath, with additional parameters
  241. sandbox.selectNodes=function(xPath,params){try{params=(params||{});var doc = (params.doc||document), node = (params.node||doc); return doc.evaluate(xPath,node,null,(params['type']||6),null);}catch(e){log("wmLibrary.selectNodes: "+e);}};
  242.  
  243. //return single selected node using xpath, with additional parameters
  244. sandbox.selectSingleNode=function(xPath,params){try{params=params||{}; params['type']=9;return selectNodes(xPath,params).singleNodeValue;}catch(e){log("wmLibrary.selectSingleNode: "+e);}};
  245.  
  246. //for the selected nodes using xpath and additional parameters, perform passed function
  247. sandbox.forNodes=function(xPath,params,fx){try{if(!fx) return;var nodes = selectNodes(xPath,params);if (nodes.snapshotLength) {for (var i=0,node;(node=nodes.snapshotItem(i));i++) {fx(node);}}nodes=null;}catch(e){log("wmLibrary.forNodes: "+e);}};
  248.  
  249. //fetch the selected elements from an html select multi into an array
  250. //this fetches the ELEMENT not its value
  251. sandbox.getSelectedOptions=function(elem){try{
  252. 	var ret=[];
  253. 	for (var i=0; i<elem.options.length; i++) {
  254. 		if (elem.options[i].selected) ret.push(elem.options[i]);
  255. 	}
  256. 	return ret;
  257. }catch(e){log("wmLibrary.getSelectedOptions: "+e);}};
  258.  
  259. //fetch the selected values from an html select multi into an array
  260. //this fetches the VALUE not the element
  261. sandbox.getSelectedOptionValues=function(elem){try{
  262. 	var ret=[];
  263. 	for (var i=0; i<elem.options.length; i++) {
  264. 		if (elem.options[i].selected) ret.push(elem.options[i].value);
  265. 	}
  266. 	return ret;
  267. }catch(e){log("wmLibrary.getSelectedOptionValues: "+e);}};
  268.  
  269. //attach an array of elements to a node
  270. sandbox.appendChildren = function(node,arr){try{for (var i=0,len=arr.length;i<len;i++){node.appendChild(arr[i]);};}catch(e){log("wmLibrary.appendChildren: "+e);}};
  271.  
  272. //create a set of options for a selection list based on an array
  273. sandbox.optionsFromArray = function(arr){try{var ret=[];for (var i=0,len=arr.length;i<len;i++) {ret.push(createElement("option",{value:arr[i],textContent:arr[i]}));};return ret;}catch(e){log("wmLibrary.optionsFromArray: "+e);}};
  274.  
  275. //select an element from a dropdown box with a certain value
  276. sandbox.selectDropDownElement = function(obj,value){try{var node = selectSingleNode(".//option[@value='"+value+"']",{node:obj});if (node) node.selected=true;}catch(e){log("wmLibrary.selectDropDownElement: "+e);}};
  277.  
  278. //return the value of a dropdown's selected inded
  279. sandbox.valueOfSelect = function(obj){try{return obj.options[obj.selectedIndex].value;}catch(e){log("wmLibrary.valueOfSelect: "+e);}};
  280.  
  281. //hides all snapshots or iterations in an xpathResult object
  282. sandbox.hideNodes=function(xPath,params) {try{forNodes(xPath,params,function(item){item.style.display="none";});}catch(e){log("wmLibrary.hideNodes: "+e);}};
  283.  
  284. //unhides all snapshots or iterations in an xpathResult object
  285. sandbox.showNodes=function(xPath,params) {try{forNodes(xPath,params,function(item){item.style.display="";});}catch(e){log("wmLibrary.showNodes: "+e);}};
  286.  
  287. //move element up
  288. sandbox.elementMoveUp=function(e){try{
  289. 	//if this element has a parent
  290. 	if (e.parentNode) {
  291. 		//and its not the first child
  292. 		if (e.parentNode.firstChild!=e){
  293. 			//move it to just before its previous sibling
  294. 			e.parentNode.insertBefore(e,e.previousSibling);
  295. 		}
  296. 	}
  297. 	return e;
  298. }catch(e){log("wmLibrary.elementMoveUp: "+e);}};
  299.  
  300. //move element down
  301. sandbox.elementMoveDown=function(e){try{
  302. 	//if this element has a parent
  303. 	if (e.parentNode) {
  304. 		//and its not the last child
  305. 		if (e.parentNode.lastChild!=e){
  306. 			//if the next sibling IS the last child
  307. 			if (e.parentNode.lastChild==e.nextSibling){
  308. 				//just move it to the bottom
  309. 				e.parentNode.appendChild(e);
  310. 			} else {
  311. 				//insert it between the next sibling and the next next sibling
  312. 				e.parentNode.insertBefore(e,e.nextSibling.nextSibling);
  313. 			}
  314. 		}
  315. 	}
  316. 	return e;
  317. }catch(e){log("wmLibrary.elementMoveDown: "+e);}};
  318.  
  319. //move element up to top of container
  320. sandbox.elementMoveTop=function(e){try{
  321. 	//if this element has a parent
  322. 	if (e.parentNode) {
  323. 		//and its not the first child
  324. 		if (e.parentNode.firstChild!=e){
  325. 			//move it to the top of the container
  326. 			e.parentNode.insertBefore(e,e.parentNode.firstChild);
  327. 		}
  328. 	}
  329. 	return e;
  330. }catch(e){log("wmLibrary.elementMoveTop: "+e);}};
  331.  
  332. //move element up to top of container
  333. sandbox.elementMoveBottom=function(e){try{
  334. 	//if this element has a parent
  335. 	if (e.parentNode) {
  336. 		//and its not the first child
  337. 		if (e.parentNode.lastChild!=e){
  338. 			//move it to the bottom of the container
  339. 			e.parentNode.appendChild(e);
  340. 		}
  341. 	}
  342. 	return e;
  343. }catch(e){log("wmLibrary.elementMoveBottom: "+e);}};
  344.  
  345. //sort an element's children by an attribute
  346. sandbox.elementSortChildren=function(e,by){try{
  347. 	by=by||"name";	
  348. 	if (e && e.childNodes) {
  349. 		//pack into an array
  350. 		var ret=[];
  351. 		for (var n=0;n<e.childNodes.length;n++) {
  352. 			ret.push(e.childNodes[n]);
  353. 		}
  354. 		//sort the array
  355. 		ret.sort(function(a,b){return a[by]>b[by]});
  356. 		//fix order of display
  357. 		for (var n=0;n<ret.length;n++) {
  358. 			e.appendChild(ret[n]);
  359. 		}
  360. 		//clean up
  361. 		ret=null;
  362. 	}
  363. }catch(e){log("wmLibrary.elementSortChildren: "+e);}};
  364.  
  365. //remove all of a node's child nodes
  366. sandbox.removeAllChildren=function(e){
  367. 	var node=e.childNodes[0];
  368. 	while (node) {
  369. 		remove(node);
  370. 		node=e.childNodes[0];
  371. 	}
  372. };
  373.  
  374. //return the real url of a location
  375. sandbox.realURL=function() {try{var u=window.location.href, host=window.location.host, protocol=window.location.protocol+"//", hash=window.location.hash;if(hash!="" && (/#\/.*\.php/).test(hash)) u=protocol+host+hash.split("#")[1];else if(hash!="" && hash.find("#")) u=u.split("#")[0];if (u.substr(-1) === "#") u=u.split("#")[0];return u;}catch(e){log("wmLibrary.realURL: "+e);}};
  376.  
  377. // compile and return the true x,y scroll offset onscreen of an element in Firefox	
  378. sandbox.trueScrollOffset = function(o){try{
  379. 	var offset={left:o.scrollLeft,top:o.scrollTop}, parentOffset=null;
  380. 	if (!(o==document.body) && !(0==document.documentElement) && o.parentNode) parentOffset=trueScrollOffset(o.parentNode);
  381. 	if (parentOffset) {
  382. 		offset.left+=parentOffset.left||0;
  383. 		offset.top+=parentOffset.top||0;
  384. 	}
  385. 	return offset;
  386. }catch(e){log("wmLibrary.trueScrollOffset: "+e);}},
  387.  
  388. // compile and return the true x,y offset onscreen of an element in Firefox
  389. sandbox.trueOffset = function(o){try{
  390. 	var offset={left:o.offsetLeft,top:o.offsetTop}, parentOffset=null;
  391. 	if (o.offsetParent) parentOffset=trueOffset(o.offsetParent);
  392. 	if (parentOffset) {
  393. 		offset.left+=parentOffset.left||0;
  394. 		offset.top+=parentOffset.top||0;
  395. 	}
  396. 	return offset;
  397. }catch(e){log("wmLibrary.trueOffset: "+e);}},
  398.  
  399. //force a page to transition to new location s even if changing the document location does not work
  400. sandbox.linkTo = function(s) {try{
  401. 	var link=document.body.appendChild(createElement("a",{href:s,target:"_top"}));
  402. 	click(link);
  403. }catch(e){log("wmLibrary.linkTo: "+e);}};
  404.  
  405. //***************************************************************************************************************************************
  406. //***** Date/Time
  407. //***************************************************************************************************************************************
  408.  
  409. //return a unix timestamp
  410. sandbox.timeStamp=function(){try{return (new Date()).getTime();}catch(e){log("wmLibrary.timeStamp: "+e);}};
  411.  
  412. //return a facebook timestamp without millisecond data
  413. sandbox.timeStampNoMS=function(){try{var t=timeStamp().toString(); return t.substr(0,t.length-3);}catch(e){log("wmLibrary.timeStampNoMS: "+e);}};
  414.  
  415. //returns a guaranteed unique timestamp in base36 prefixed with an underscore
  416. sandbox.unique=function(){try{var now=timeStamp();var newnow=now;while (newnow==now){newnow=timeStamp();} return "_"+(newnow.toString(36));}catch(e){log("wmLibrary.unique: "+e);}};
  417.  
  418. //***************************************************************************************************************************************
  419. //***** String Prototype Additions
  420. //***************************************************************************************************************************************
  421.  
  422. //return true if string starts with s
  423. sandbox.String.prototype.startsWith = function(s) {try{if (this.length<s.length) return false; else return (this.substring(0,s.length)===s)}catch(e){log("wmLibrary.String.prototype.startsWith: "+e);}};
  424.  
  425. //return true if string ends with s
  426. sandbox.String.prototype.endsWith = function(s) {try{if (this.length<s.length) return false; else return (this.substring(this.length-s.length,s.length)===s)}catch(e){log("wmLibrary.String.prototype.endsWith: "+e);}};
  427.  
  428. //return true if string contains s
  429. sandbox.String.prototype.find = function(s) {try{
  430. 	return (this.indexOf(s) != -1);
  431. }catch(e){log("wmLibrary.String.prototype.find: "+e);}};
  432. sandbox.String.prototype.contains = function(s) {return this.find(s);};
  433.  
  434. //inserts string s into this string at position startIndex
  435. sandbox.String.prototype.insert = function(s,startIndex) {try{
  436. 	return this.substr(0,startIndex)+s+this.substr(startIndex,this.length-startIndex);
  437. }catch(e){log("wmLibrary.String.prototype.insert: "+e);}};
  438.  
  439. //pads the string with space or a specific character, on the left
  440. //strings already longer than totalLength are not changed
  441. sandbox.String.prototype.padLeft = function(totalLength,c) {try{
  442. 	c=(c||" ").charAt(0);
  443. 	if (totalLength>0){
  444. 		return (totalLength<=this.length)?this:
  445. 			c.repeat((totalLength-this.length))+this;
  446. 	}
  447. }catch(e){log("wmLibrary.String.prototype.padLeft: "+e);}};
  448.  
  449. //pads the string with space or a specific character, on the left
  450. //strings already longer than totalLength are not changed
  451. sandbox.String.prototype.padRight = function(totalLength,c) {try{
  452. 	c=(c||" ").charAt(0);
  453. 	if (totalLength>0){
  454. 		return (totalLength<=this.length)?this:
  455. 			this+c.repeat((totalLength-this.length));
  456. 	}
  457. }catch(e){log("wmLibrary.String.prototype.padright: "+e);}};
  458.  
  459. //return the string as an array of characters
  460. sandbox.String.prototype.toCharArray = function() {try{
  461. 	return this.split(/(.|\n|\r)/g);
  462. }catch(e){log("wmLibrary.String.prototype.toCharArray: "+e);}};
  463.  
  464. //return the passed string minus spaces
  465. sandbox.String.prototype.noSpaces = function(s) {try{return (this.replace(/\s+/g,''));}catch(e){log("wmLibrary.String.prototype.noSpaces: "+e);}};
  466.  
  467. //return the passed string with word first letters capitalized
  468. sandbox.String.prototype.upperWords = function(s) {try{return (this+'').replace(/^(.)|\s(.)/g, function($1){return $1.toUpperCase();});}catch(e){log("wmLibrary.String.prototype.upperWords: "+e);}};
  469.  
  470. //return the passed string repeated n times
  471. sandbox.String.prototype.repeat = function(n) {try{return new Array(n+1).join(this);}catch(e){log("wmLibrary.String.prototype.repeat: "+e);}};
  472.  
  473. //return the passed string minus line breaks
  474. sandbox.String.prototype.noLineBreaks = function(s) {try{return (this.replace(/(\r\n|\n|\r)/gm," "));}catch(e){log("wmLibrary.String.prototype.noLineBreaks: "+e);}};
  475.  
  476. //return the passed string without beginning or ending quotes
  477. sandbox.String.prototype.unQuote = function() {try{return this.replace(/^"|"$/g, '');}catch(e){log("wmLibrary.String.prototype.unQuote: "+e);}};
  478.  
  479. //return the passed string without beginning or ending quotes
  480. sandbox.String.prototype.quote = function() {try{return "\""+this+"\"";}catch(e){log("wmLibrary.String.prototype.quote: "+e);}};
  481.  
  482. //return the passed string without beginning or ending brackets
  483. sandbox.String.prototype.unBracket = function() {try{return this.replace(/^\[|\]$/g, '');}catch(e){log("wmLibrary.String.prototype.unBracket: "+e);}};
  484.  
  485. //return the passed string without beginning spaces
  486. sandbox.String.prototype.trimStart = function(){try{
  487. 	return this.replace(/^\s\s*/, '');
  488. }catch(e){log("wmLibrary.String.prototype.trimStart: "+e);}};
  489.  
  490. //return the passed string without ending spaces
  491. sandbox.String.prototype.trimEnd = function(){try{
  492. 	return this.replace(/\s\s*$/, '');
  493. }catch(e){log("wmLibrary.String.prototype.trimEnd: "+e);}};
  494.  
  495. //return the passed string without beginning or ending spaces
  496. sandbox.String.prototype.trim = function(){try{
  497. 	return this.replace(/^\s\s*/, '').replace(/\s\s*$/, '');
  498. }catch(e){log("wmLibrary.String.prototype.trim: "+e);}};
  499.  
  500. //assuming passed string is a url parameter list, return named parameter's value or ""
  501. //this works great for both search and hash parts
  502. //do not pass a document.location without first splitting off search and hash parts
  503. sandbox.String.prototype.getUrlParam = function(s) {try{
  504. 	var r=this.removePrefix("#").removePrefix("?").split("&");
  505. 	for (var p=0,param;(param=r[p]);p++){
  506. 		if ( param.startsWith(s+"=") || param==s ) {
  507. 			return (param.split("=")[1]||null);
  508. 		}
  509. 	}	
  510. 	return null;
  511. }catch(e){log("wmLibrary.String.prototype.getUrlParam: "+e);}};
  512.  
  513. //return passed string with word added to end. words are separated by spaces
  514. //alternately accepts an array of words to add
  515. sandbox.String.prototype.addWord= function(word){try{
  516. 	if (!isArray(word)) word=[word];
  517. 	var words = this.split(" ");
  518. 	var ret=this;
  519. 	for (var w=0,len=word.length;w<len;w++){
  520. 		if (!words.inArray(word[w])) ret=ret+" "+word;
  521. 	}
  522. 	return ret;
  523. }catch(e){log("wmLibrary.String.prototype.addWord: "+e);}};
  524.  
  525. //return passed string minus specified word
  526. //alternately accepts an array of words to remove
  527. sandbox.String.prototype.removeWord= function(word){try{
  528. 	if (!isArray(word)) word=[word]; 
  529. 	var words=this.split(" ");
  530. 	var ret;
  531. 	for (var w=0,len=word.length;w<len;w++){
  532. 		ret = words.removeByValue(word[w]); 
  533. 	}
  534. 	return ret.join(" ");
  535. }catch(e){log("wmLibrary.String.prototype.removeWord: "+e);}};
  536.  
  537. //return true if passed string contains word
  538. sandbox.String.prototype.containsWord= function(word){try{return this.split(" ").inArray(word);}catch(e){log("wmLibrary.String.prototype.containsWord: "+e);}};
  539.  
  540. //return passed string with word replaced with word2
  541. sandbox.String.prototype.replaceWord= function(word,word2){try{return this.split(" ").replace(word,word2).join(" ");}catch(e){log("wmLibrary.String.prototype.replaceWord: "+e);}};
  542.  
  543. //return passed string with word toggled
  544. sandbox.String.prototype.toggleWord= function(word){try{if (this.containsWord(word)) return this.removeWord(word); return this.addWord(word);}catch(e){log("wmLibrary.String.prototype.toggleWord: "+e);}};
  545.  
  546. //return passed string with word toggled based on a boolean input
  547. sandbox.String.prototype.toggleWordB = function(bool,word){try{
  548. 	return this[(bool?"add":"remove")+"Word"](word);
  549. }catch(e){log("wmLibrary.String.prototype.toggleWordB: "+e);}};
  550.  
  551. //return passed string with word swapped for another based on a boolean input
  552. //if bool==true then we return string including word1 and excluding word2
  553. //else we return string including word2 and excluding word1
  554. sandbox.String.prototype.swapWordB = function(bool,word1,word2){try{
  555. 	return this.replaceWord((bool?word2:word1),(bool?word1:word2));
  556. }catch(e){log("wmLibrary.String.prototype.swapWordB: "+e);}};
  557.  
  558. //return passed string minus prefix of s if it exists
  559. sandbox.String.prototype.removePrefix = function(s){try{if (this.startsWith(s)) {return this.substring(s.length);} else return this;}catch(e){log("wmLibrary.String.prototype.removePrefix: "+e);}};
  560.  
  561. //return passed string minus suffix of s if it exists
  562. sandbox.String.prototype.removeSuffix = function(s){try{if (this.endsWith(s)) {return this.substring(0,this.length-s.length);} else return this;}catch(e){log("wmLibrary.String.prototype.removeSuffix: "+e);}};
  563.  
  564. // visual basic alternate for string.toLowerCase()
  565. sandbox.String.prototype.lcase = function() {try{return this.toLowercase();}catch(e){log("wmLibrary.String.prototype.lcase: "+e);}};
  566.  
  567. // visual basic alternate for string.toUpperCase()
  568. sandbox.String.prototype.ucase = function() {try{return this.toUppercase();}catch(e){log("wmLibrary.String.prototype.ucase: "+e);}};
  569. 	
  570. // copy the calling string to the clipboard (IE or GM)
  571. sandbox.String.prototype.toClipboard = function() {try{
  572. 	if (window.clipboardData){  
  573. 		window.clipboardData.setData("Text", this);
  574. 	} else if (unsafeWindow) {  
  575. 		try{
  576. 			unsafeWindow.netscape.security.PrivilegeManager.enablePrivilege("UniversalXPConnect");
  577. 		} catch(e){
  578. 			log("wmLibrary.String.prototype.toClipboard: Cannot enable privelege 'UniversalXPConnect'. Be sure that 'signed.applets.codebase_principal_support' is set to true in 'about:config'");
  579. 		}
  580. 		const clipboardHelper = Components.classes["@mozilla.org/widget/clipboardhelper;1"].getService(Components.interfaces.nsIClipboardHelper);  
  581. 		clipboardHelper.copyString(this);
  582. 	} else {
  583. 		log("wmLibrary.String.prototype.toClipboard: Cannot perform task");
  584. 	}
  585. } catch(e){log("wmLibrary.String.prototype.toClipboard: "+e);}};
  586.  
  587. //replaces all instances of {x} with passed argument x
  588. //or arguments[0][x] when the first argument is an array
  589. sandbox.String.prototype.format = function() {try{
  590.     var ret = this;
  591.     var args=arguments; //use argument mode
  592.     if (isArray(args[0])) args=args[0]; //switch to array mode
  593.     for (var i = 0; i < args.length; i++) {
  594.         var re = new RegExp('\\{'+i+'\\}', 'gi');
  595.         ret = ret.replace(re, args[i]);
  596.     }
  597.     return ret;
  598. }catch(e){log("wmLibrary.String.prototype.format: "+e);}};
  599.  
  600. //similar to String.format, except that instances of {%x} are replaced
  601. //instead of instances of {x}
  602. sandbox.String.prototype.format2 = function() {try{
  603.     var ret = this;
  604.     var args=arguments; //use argument mode
  605.     if (isArray(args[0])) args=args[0]; //switch to array mode
  606.     for (var i=0; i < args.length; i++) {
  607.         var re = new RegExp('\\{%'+i+'\\}', 'gi');
  608.         ret = ret.replace(re, args[i]);
  609.     }
  610.     return ret;
  611. }catch(e){log("wmLibrary.String.prototype.format2: "+e);}};
  612.  
  613. //returns true if the string is zero-length
  614. sandbox.String.prototype.isEmpty = function() {try{
  615. 	return this.length==0;
  616. }catch(e){log("wmLibrary.String.prototype.isEmpty: "+e);}};
  617.  
  618. //format a JSON string with linebreaks and indents
  619. //with optional indent number to set indent length in spaces
  620. //default intent is a tab character
  621. sandbox.String.prototype.formatJSON = function(indent) {try{
  622. 	indent=(indent)?(" ").repeat(indent):"\t";
  623. 	
  624. 	//first lets convert the supposed JSON string to an actual object
  625. 	//so we can validate that it is of good format
  626. 	var topObj=JSON.parse(this);
  627. 	//if we got this far, it is valid
  628. 	
  629. 	//make a function to spell our our branches
  630. 	var writeBranch=function(obj,name,level){
  631. 		var ret="";
  632. 			
  633. 		//start our output string
  634. 		ret+=(level)?indent.repeat(level):"";
  635. 		ret+=(name)?JSON.stringify(name)+": ":"";
  636. 		ret+=(isArray(obj))?
  637. 			"["+((!obj.isEmpty())?
  638. 				"\n":
  639. 				""
  640. 			):
  641. 			(isObject(obj))?
  642. 				"{"+((!methodsToArray(obj).isEmpty())?
  643. 					"\n":
  644. 					""
  645. 				):
  646. 			"";
  647. 			
  648. 		//draw the inside object(s)
  649. 		var c=0;
  650. 		if (isArray(obj)) for (var i=0,len=obj.length;i<len;i++){
  651. 			//write arrays out
  652. 			if (i>0) ret+=",\n";
  653. 			ret+=writeBranch(obj[i],null,level+1);
  654. 		} else if (isObject(obj)) for (var i in obj){
  655. 			if (c>0) ret+=",\n";
  656. 			//write objects out
  657. 			ret+=writeBranch(obj[i],i,level+1);
  658. 			c++;
  659. 		} else {
  660. 			//branch is not an object or array
  661. 			ret+=JSON.stringify(obj);
  662. 		}
  663. 			
  664. 		//end our output string
  665. 		ret+=(isArray(obj))?
  666. 			((!obj.isEmpty())?
  667. 				"\n"+((level)?
  668. 					indent.repeat(level):
  669. 					""
  670. 				):
  671. 				""
  672. 			)+"]":
  673. 			(isObject(obj))?
  674. 				((!methodsToArray(obj).isEmpty())?
  675. 					"\n"+((level)?
  676. 						indent.repeat(level):
  677. 						""
  678. 					):
  679. 					""
  680. 				)+"}":
  681. 			"";
  682. 			
  683. 		//back to previous branch
  684. 		return ret;
  685. 	}
  686. 	
  687. 	//start writing the branches
  688. 	return writeBranch(topObj,null,0);
  689. }catch(e){log("wmLibrary.String.prototype.formatJSON: "+e);}};
  690.  
  691. //returns the longested quoted text within the calling string
  692. sandbox.String.prototype.longestQuoteWithin = function() {try{
  693. 	var p=0, c=0, s="", a=0, b=0, l=0;
  694. 	while (p<this.length){
  695. 		a=this.indexOf('"', p);
  696. 		if (a!=-1) {
  697. 			p=a+1;
  698. 			b=this.indexOf('"',p);
  699. 			if (b!=-1) {
  700. 				p=b+1;
  701. 			        l=b-a;
  702. 				if (l>c) {
  703. 					c=l;
  704. 					s=this.substr(a+1,l-1);
  705. 				}
  706. 			} else {
  707. 				p=this.length;
  708. 			}
  709. 		} else {
  710. 			p=this.length;
  711. 		}
  712. 	}
  713. 	return s;
  714. }catch(e){log("wmLibrary.String.prototype.longestQuoteWithin: "+e);}};
  715.  
  716. //***************************************************************************************************************************************
  717. //***** Array Prototype Additions
  718. //***************************************************************************************************************************************
  719.  
  720. //returns true if the array is zero-length
  721. sandbox.Array.prototype.isEmpty = function() {try{
  722. 	return this.length==0;
  723. }catch(e){log("wmLibrary.Array.prototype.isEmpty: "+e);}};
  724.  
  725. //return passed array with element x and element y swapped
  726. sandbox.Array.prototype.swap = function (x,y) {try{
  727. 	var b = this[x];
  728. 	this[x] = this[y];
  729. 	this[y] = b;
  730. 	return this;
  731. }catch(e){log("wmLibrary.Array.prototype.swap: "+e);}};
  732.  
  733. //return true if a value exists in the array
  734. //with optional startIndex
  735. //and optional count which specifies the number of elements to examine
  736. sandbox.Array.prototype.inArray = function(value,startIndex,count) {try{
  737. 	startIndex=startIndex||0;
  738. 	if (startIndex>=this.length) {
  739. 		//log("wmLibrary.Array.prototype.inArray: Error: startIndex out of bounds");
  740. 		return false;
  741. 	}
  742. 	if (exists(count) && count<1) {
  743. 		//log("wmLibrary.Array.prototype.inArray: Error: count is less than 1");
  744. 		return false;
  745. 	}
  746. 	var c=0;
  747. 	for(var i=this.length-1; (i>=startIndex && (!exists(count) || (exists(count) && c<count))); i--) {
  748. 		c++;
  749. 		if(this[i]==value) return true;
  750. 	} 
  751. 	return false;
  752. }catch(e){log("wmLibrary.Array.prototype.inArray: "+e);}};
  753.  
  754. //alias for inArray
  755. sandbox.Array.prototype.contains = function(value,startIndex,count) {return this.inArray(value,startIndex,count);};
  756.  
  757. //return the location of a value in an array
  758. //with optional startIndex
  759. //and optional count which specifies the number of elements to examine
  760. sandbox.Array.prototype.inArrayWhere = function(value,startIndex,count) {try{
  761. 	startIndex=startIndex||0;
  762. 	if (startIndex>=this.length) {
  763. 		//log("wmLibrary.Array.prototype.inArrayWhere: Error: startIndex out of bounds");
  764. 		return -1;
  765. 	}
  766. 	if (exists(count) && count<1) {
  767. 		//log("wmLibrary.Array.prototype.inArrayWhere: Error: count is less than 1");
  768. 		return -1;
  769. 	}
  770. 	var c=0;
  771. 	for(var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++) {
  772. 		c++;
  773. 		if(this[i]==value) return i;
  774. 	}
  775. 	return -1;
  776. }catch(e){log("wmLibrary.Array.prototype.inArrayWhere: "+e);}};
  777. //alias for inArrayWhere
  778. sandbox.Array.prototype.indexOf = function(value,startIndex,count) {return this.inArrayWhere(value,startIndex,count);};
  779.  
  780. //return the location of the last occurence of value in an array
  781. //with optional startIndex
  782. //and optional count which specifies the number of elements to examine
  783. sandbox.Array.prototype.lastIndexOf = function(value,startIndex,count) {try{
  784. 	startIndex=startIndex||0;
  785. 	if (startIndex>=this.length) {
  786. 		//log("wmLibrary.Array.prototype.lastIndexOf: Error: startIndex out of bounds");
  787. 		return -1;
  788. 	}
  789. 	if (exists(count) && count<1) {
  790. 		//log("wmLibrary.Array.prototype.lastIndexOf: Error: count is less than 1");
  791. 		return -1;
  792. 	}
  793. 	var c=0;
  794. 	for(var i=this.length; (i>=startIndex && (!exists(count) || (exists(count) && c<count))); i++) {
  795. 		c++;
  796. 		if(this[i]==value) return i;
  797. 	}
  798. 	return -1;
  799. }catch(e){log("wmLibrary.Array.prototype.lastIndexOf: "+e);}};
  800.  
  801. //return true if the location of value is 0
  802. sandbox.Array.prototype.startsWith = function(value){return this.inArrayWhere(value)===0;}
  803.  
  804. //return the last value in an array
  805. sandbox.Array.prototype.last = function() {try{return this[this.length - 1];}catch(e){log("wmLibrary.Array.prototype.last: "+e);}};
  806.  
  807. //return true if the content of the last index is equal to value
  808. sandbox.Array.prototype.endsWith = function(value){return this.last()===value;}
  809.  
  810. //return the array will spaces removed from every element
  811. sandbox.Array.prototype.noSpaces = function() {try{for(var i=0,l=this.length; i<l; i++) {this[i]=this[i].noSpaces();}; return this;}catch(e){log("wmLibrary.Array.prototype.noSpaces: "+e);}};
  812.  
  813. //remove the first instance of a value in an array
  814. //now accepts an array of values to remove
  815. //removes the first instance of every item in array passed
  816. //returns the calling array
  817. sandbox.Array.prototype.removeByValue = function(values) {try{
  818. 	if (!isArray(values)) values=[values];
  819. 	for (var i=0,len=values.length; i<len;i++) {
  820. 		var e=this.inArrayWhere(values[i]);
  821. 		if(e>=0)this.splice(e,1);
  822. 	}
  823. 	return this;
  824. }catch(e){log("wmLibrary.Array.prototype.removeByValue: "+e);}};
  825.  
  826. //replace all instances of a value in an array
  827. //returns the calling array
  828. sandbox.Array.prototype.replaceAll = function(val, val2) {try{
  829. 	var i=this.inArrayWhere(val);
  830. 	while(i>=0) {
  831. 		this[i]=val2;
  832. 		i=this.inArrayWhere(val,i+1);
  833. 	}
  834. 	return this;
  835. }catch(e){log("wmLibrary.Array.prototype.replaceAll: "+e);}};
  836.  
  837. //remove all instances of a value in an array
  838. //now accepts an array of values to remove
  839. //returns the calling array
  840. sandbox.Array.prototype.removeAllByValue = function(values) {try{
  841. 	if (!isArray(values)) values=[values];
  842. 	for (var i=0,len=values.length; i<len;i++) {
  843. 		var e=this.inArrayWhere(values[i]);
  844. 		while (e>=0){
  845. 			if(e>=0)this.splice(e,1);
  846. 			e=this.inArrayWhere(values[i],e+1);
  847. 		}
  848. 	}
  849. 	return this;
  850. }catch(e){log("wmLibrary.Array.prototype.removeAllByValue: "+e);}};
  851.  
  852. //replace the first instance of a value in an array
  853. //returns the calling array
  854. sandbox.Array.prototype.replace = function(val, val2) {try{var i=this.inArrayWhere(val);if(i>=0)this[i]=val2;return this;}catch(e){log("wmLibrary.Array.prototype.replace: "+e);}};
  855.  
  856.  
  857. //remove element i of an array
  858. //returns the calling array
  859. sandbox.Array.prototype.remove = function(i) {try{this.splice(i,1); return this;}catch(e){log("wmLibrary.Array.prototype.remove: "+e);}};
  860.  
  861. //remove elements beyond specified new size
  862. //or add elements to fill the new size equal to defaultValue
  863. sandbox.Array.prototype.resize = function(newSize,defaultValue) {try{
  864. 	if (this.length>newSize) {
  865. 		this.splice(newSize,this.length-newSize); 
  866. 	} else {
  867. 		for (var i=this.length;i<newSize;i++){
  868. 			this[i]=defaultValue;
  869. 		}
  870. 	}
  871. 	return this;
  872. }catch(e){log("wmLibrary.Array.prototype.resize: "+e);}};
  873.  
  874. //return a random element of an array
  875. sandbox.Array.prototype.pickRandom = function () {try{var i=Math.floor(Math.random()*this.length); return this[i];}catch(e){log("wmLibrary.Array.prototype.pickRandom: "+e);}};
  876.  
  877. //sorts an array by string length, priming it for text searches, putting longest strings first so that "pea" is not found before "peanut"
  878. //returns the calling array
  879. sandbox.Array.prototype.optimize = function(){try{if (this.length>1) {for (var i=this.length-1;i>0;i--) {for (var i2=i-1;i2>0;i2--){if (this[i].length > this[i2].length) {var b=this[i]; this[i]=this[i2]; this[i2]=b; b=null;}}}}; return this;}catch(e){log("wmLibrary.Array.prototype.optimize: "+e);}};
  880.  
  881. //returns a shallow copy of the calling array
  882. sandbox.Array.prototype.clone = function(){try{
  883. 	var ret=[];
  884. 	if (this.length) for (var i=0,len=this.length; i<len; i++){
  885. 		ret.push(this[i]);
  886. 	}
  887. 	return ret;
  888. }catch(e){log("wmLibrary.Array.prototype.clone: "+e);}};
  889.  
  890. //reverses the elements of an array
  891. //with optional startIndex
  892. //and optional count which limits the reverse section
  893. //if startIndex+count is greater than the length of the array 
  894. //then only the available section is reversed
  895. //returns the calling array
  896. sandbox.Array.prototype.reverse = function(startIndex,count){try{
  897. 	startIndex=startIndex||0;
  898. 	if (startIndex>=this.length) {
  899. 		//log("wmLibrary.Array.prototype.reverse: Error: startIndex out of bounds");
  900. 		return -1;
  901. 	}
  902. 	if (exists(count) && count<1) {
  903. 		//log("wmLibrary.Array.prototype.reverse: Error: count is less than 1");
  904. 		return -1;
  905. 	}
  906. 	var endIndex=(exists(count))?startIndex+count:this.length-1;
  907. 	if (endIndex>this.length-1) endIndex=this.length-1;
  908. 	while (startIndex>endIndex){
  909. 		this.swap(startIndex,endIndex);
  910. 		startIndex++;
  911. 		endIndex--;
  912. 	}
  913. 	return this;
  914. }catch(e){log("wmLibrary.Array.prototype.reverse: "+e);}};
  915.  
  916. //sets a range of elements in the array to the defaultValue
  917. //returns the calling array
  918. sandbox.Array.prototype.clear = function(startIndex,count,defaultValue){try{
  919. 	if (count>0 && this.length>startIndex) {
  920. 		for (var i=startIndex,len=this.length; (i<len && i<(startIndex+count)); i++){
  921. 			this[i]=defaultValue;
  922. 		}
  923. 	}
  924. 	return this;
  925. }catch(e){log("wmLibrary.Array.prototype.clear: "+e);}};
  926.  
  927. //copies elements from this array to a destination destArray
  928. //starting in this array at sourceIndex
  929. //and pasting into the destArray at destIndex
  930. //where length is the number of elements to copy
  931. //pasting beyond the higher bounds of the destArray simply increases the array size
  932. //returns the calling array
  933. sandbox.Array.prototype.copy = function(sourceIndex,destArray,destIndex,length){try{
  934. 	if (!isArray(destArray)) {
  935. 		log("wmLibrary.Array.prototype.copy: Error: destArray is not an array");
  936. 		return this;
  937. 	}
  938. 	if (sourceIndex >= this.length) {
  939. 		//log("wmLibrary.Array.prototype.copy: Error: sourceIndex out of bounds");
  940. 		return this;
  941. 	}
  942. 	for (var i=0; i<length; i++){
  943. 		destArray[destIndex+i]=this[sourceIndex+i];
  944. 	}
  945. 	return this;
  946. }catch(e){log("wmLibrary.Array.prototype.copy: "+e);}};
  947.  
  948. //copies all elements from this array to a destination destArray
  949. //pasting into the destArray at destIndex
  950. //pasting beyond the higher bounds of the destArray simply increases the array size
  951. //returns the calling array
  952. sandbox.Array.prototype.copyTo = function(destArray,destIndex){try{
  953. 	if (!isArray(destArray)) {
  954. 		log("wmLibrary.Array.prototype.copyTo: Error: destArray is not an array");
  955. 		return this;
  956. 	}
  957. 	for (var i=0, len=this.length; i<len; i++){
  958. 		destArray[destIndex+i]=this[i];
  959. 	}
  960. 	return this;
  961. }catch(e){log("wmLibrary.Array.prototype.copyTo: "+e);}};
  962.  
  963. //returns an array containing elements from the current array where the element has parameter p equal to value v
  964. sandbox.Array.prototype.selectByParam = function(p,v) {try{var ret=[]; for(i=0;i<this.length;i++) if(this[i][p]==v) ret.push(this[i]); return ret;}catch(e){log("wmLibrary.Array.prototype.selectByParam: "+e);}};
  965.  
  966. //returns the element matched by matchFunc, or null
  967. //with optional start index
  968. //and optional count to limit the number of searched elements
  969. sandbox.Array.prototype.find = function(matchFunc,startIndex,count) {try{
  970. 	startIndex=startIndex||0;
  971. 	if (startIndex>=this.length) {
  972. 		//log("wmLibrary.Array.prototype.find: Error: startIndex out of bounds");
  973. 		return null;
  974. 	}
  975. 	if (exists(count) && count<1) {
  976. 		//log("wmLibrary.Array.prototype.find: Error: count is less than 1");
  977. 		return null;
  978. 	}
  979. 	var c=0;
  980. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  981. 		c++;
  982. 		if (matchFunc(this[i])) {
  983. 			return this[i];
  984. 			break;
  985. 		}
  986. 	}
  987. 	return null;
  988. }catch(e){log("wmLibrary.Array.prototype.find: "+e);}};
  989.  
  990. //returns the index of element matched by matchFunc, or -1
  991. //with optional startIndex
  992. //and optional count which specifies the number of elements to check
  993. sandbox.Array.prototype.findIndex = function(matchFunc,startIndex,count) {try{
  994. 	startIndex=startIndex||0;
  995. 	if (startIndex>=this.length) {
  996. 		//log("wmLibrary.Array.prototype.findIndex: Error: startIndex out of bounds");
  997. 		return -1;
  998. 	}
  999. 	if (exists(count) && count<1) {
  1000. 		//log("wmLibrary.Array.prototype.findIndex: Error: count is less than 1");
  1001. 		return -1;
  1002. 	}
  1003. 	var c=0;
  1004. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  1005. 		c++;
  1006. 		if (matchFunc(this[i])) {
  1007. 			return i;
  1008. 			break;
  1009. 		}
  1010. 	}
  1011. 	return -1;
  1012. }catch(e){log("wmLibrary.Array.prototype.findIndex: "+e);}};
  1013.  
  1014. //returns all elements matched by matchFunc, or null
  1015. //with optional start index
  1016. //and optional count to limit the number of elements searched
  1017. sandbox.Array.prototype.findAll = function(matchFunc,startIndex,count) {try{
  1018. 	startIndex=startIndex||0;
  1019. 	var ret=[];
  1020. 	if (startIndex>=this.length) {
  1021. 		//log("wmLibrary.Array.prototype.findAll: Error: startIndex out of bounds");
  1022. 		return null;
  1023. 	}
  1024. 	if (exists(count) && count<1) {
  1025. 		//log("wmLibrary.Array.prototype.findAll: Error: count is less than 1");
  1026. 		return null;
  1027. 	}
  1028. 	var c=0;
  1029. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  1030. 		c++;
  1031. 		if (matchFunc(this[i])) {
  1032. 			ret.push(this[i]);
  1033. 		}
  1034. 	}
  1035. 	return (isArrayAndNotEmpty(ret))?ret:null;
  1036. }catch(e){log("wmLibrary.Array.prototype.findAll: "+e);}};
  1037.  
  1038. //returns true if all elements in the array match the matchFunc
  1039. //with optional start index
  1040. //and optional count to limit the number of elements searched
  1041. sandbox.Array.prototype.trueForAll = function(matchFunc,startIndex,count) {try{
  1042. 	startIndex=startIndex||0;
  1043. 	if (startIndex>=this.length) {
  1044. 		//log("wmLibrary.Array.prototype.trueForAll: Error: startIndex out of bounds");
  1045. 		return false;
  1046. 	}
  1047. 	if (exists(count) && count<1) {
  1048. 		//log("wmLibrary.Array.prototype.trueForAll: Error: count is less than 1");
  1049. 		return false;
  1050. 	}
  1051. 	var c=0;
  1052. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  1053. 		c++;
  1054. 		if (!matchFunc(this[i])) {
  1055. 			return false;
  1056. 		}
  1057. 	}
  1058. 	return true;
  1059. }catch(e){log("wmLibrary.Array.prototype.trueForAll: "+e);}};
  1060.  
  1061. //returns true if array contains an element matched by the matchFunc
  1062. //with optional startIndex
  1063. //and optional count which specifies the number of elements to check
  1064. sandbox.Array.prototype.exists = function(matchFunc,startIndex,count) {try{
  1065. 	return this.findIndex(matchFunc,startIndex,count)!=-1;
  1066. }catch(e){log("wmLibrary.Array.prototype.exists: "+e);}};
  1067.  
  1068. //returns the last element matched by matchFunc, or null
  1069. //with optional start index
  1070. //and optional count to limit the number of searched elements
  1071. sandbox.Array.prototype.findLast = function(matchFunc,startIndex,count) {try{
  1072. 	startIndex=startIndex||0;
  1073. 	if (startIndex>=this.length) {
  1074. 		//log("wmLibrary.Array.prototype.findLast: Error: startIndex out of bounds");
  1075. 		return null;
  1076. 	}
  1077. 	if (exists(count) && count<1) {
  1078. 		//log("wmLibrary.Array.prototype.findLast: Error: count is less than 1");
  1079. 		return null;
  1080. 	}
  1081. 	var c=0;
  1082. 	for (var i=this.length; (i>=startIndex && (!exists(count) || (exists(count) && c<count))); i--){
  1083. 		c++;
  1084. 		if (matchFunc(this[i])) {
  1085. 			return this[i];
  1086. 			break;
  1087. 		}
  1088. 	}
  1089. 	return null;
  1090. }catch(e){log("wmLibrary.Array.prototype.findLast: "+e);}};
  1091.  
  1092. //returns the last element matched by matchFunc, or -1
  1093. //with optional start index
  1094. //and optional count which specifies the number of elements to check
  1095. sandbox.Array.prototype.findLastIndex = function(matchFunc,startIndex,count) {try{
  1096. 	startIndex=startIndex||0;
  1097. 	if (startIndex>=this.length) {
  1098. 		//log("wmLibrary.Array.prototype.findLastIndex: Error: startIndex out of bounds");
  1099. 		return -1;
  1100. 	}
  1101. 	if (exists(count) && count<1) {
  1102. 		//log("wmLibrary.Array.prototype.findLastIndex: Error: count is less than 1");
  1103. 		return -1;
  1104. 	}
  1105. 	var c=0;
  1106. 	for (var i=this.length; (i>=startIndex && (!exists(count) || (exists(count) && c<count))); i--){
  1107. 		c++;
  1108. 		if (matchFunc(this[i])) {
  1109. 			return i;
  1110. 			break;
  1111. 		}
  1112. 	}
  1113. 	return -1;
  1114. }catch(e){log("wmLibrary.Array.prototype.findLastIndex: "+e);}};
  1115.  
  1116. //***************************************************************************************************************************************
  1117. //***** JSON/OBJECT Construction and Matching
  1118. //***************************************************************************************************************************************
  1119.  
  1120. //returns the merge of any number of JSON objects passed as unnamed arguments
  1121. sandbox.mergeJSON_long = function(){try{
  1122. 	var ret = {}; 
  1123. 	//for each JSON object passed
  1124. 	for (var a=0,len=arguments.length;a<len;a++) {
  1125. 		//for each element in that object
  1126. 		for (var v in arguments[a]) {
  1127. 			if (!exists(ret[v])) {
  1128. 				//simply copy the element to the return value
  1129. 				ret[v] = arguments[a][v];
  1130. 			} else {
  1131. 				if ((typeof arguments[a][v])=="object") {
  1132. 					//merge the two elements, preserving tree structure
  1133. 					ret[v] = mergeJSON(ret[v], arguments[a][v]);
  1134. 				} else {
  1135. 					//overwrite simple variable
  1136. 					ret[v] = arguments[a][v];
  1137. 				}
  1138. 			}
  1139. 		}
  1140. 	}
  1141. 	//the problem here is that its way too recursive and jams firefox often
  1142. 	return ret; 
  1143. }catch(e){log("wmLibrary.mergeJSON: "+e);}};
  1144.  
  1145. sandbox.mergeJSON = function(){try{
  1146. 	var ret = {}; 
  1147. 	//for each JSON object passed
  1148. 	for (var a=0,len=arguments.length;a<len;a++) {
  1149. 		//for each element in that object
  1150. 		for (var v in arguments[a]) {
  1151. 			//replace the initial element with that of the next
  1152. 			ret[v] = arguments[a][v];
  1153. 		}
  1154. 		//the problem here is that only the top level branches are preserved
  1155. 	}
  1156. 	return ret; 
  1157. }catch(e){log("wmLibrary.mergeJSON: "+e);}};
  1158.  
  1159. //returns all members of an array that have a specified parameter with a specified value
  1160. //sandbox.matchByParam=function(arr,param,value){try{var ret=[];for (var i=0,e;(e=arr[i]);i++){if (e[param]==value) ret.push(e);};return ret;}catch(e){log("wmLibrary.matchByParam: "+e);}};
  1161. 	
  1162. //returns all members of an array that have a specified parameter with a specified value
  1163. //now accepts input of array or object
  1164. //can now specify output of array or object
  1165. sandbox.matchByParam=function(o,param,value,outputType){try{
  1166. 	if(!exists(outputType)) outputType="array";
  1167. 	var inputType=(isArray(o))?"array":((typeof o) == "object")?"object":"unknown";
  1168. 	
  1169. 	var ret=(outputType=="object")?{}:[]; //default to array on error
  1170.  
  1171. 	switch(inputType){
  1172. 		case "array": for (var i=0,e;(e=o[i]);i++){
  1173. 			switch(outputType){
  1174. 				case "array": if (e[param]==value) ret.push(e); break;
  1175. 				case "object": if (e[param]==value) ret[i]=e; break;
  1176. 			}
  1177. 		};break;
  1178.  
  1179. 		case "object": for (var i in o){
  1180. 			var e=o[i];
  1181. 			switch(outputType){
  1182. 				case "array": if (e[param]==value) ret.push(e); break;
  1183. 				case "object": if (e[param]==value) ret[i]=e; break;
  1184. 			}
  1185. 		};break;
  1186. 	}
  1187. 	return ret;
  1188. }catch(e){log("wmLibrary.matchByParam: "+e);}};
  1189.  
  1190. //sorts the methods of an object by method 'id' or method 'value'
  1191. //beware this may mangle some objects
  1192. sandbox.sortCollection=function(o,by){
  1193. 	var a=[];
  1194. 	for (var i in o){
  1195. 		a.push({id:i,value:o[i]});
  1196. 	}
  1197. 	a.sort(function(a,b){return a[by]>b[by];});
  1198. 	var ret={};
  1199. 	for (var i=0;i<a.length;i++){
  1200. 		ret[a[i].id]=a[i].value;
  1201. 	}
  1202. 	return ret;
  1203. };
  1204.  
  1205. // Collect all the values from parameter p in object o, traversing kids nodes
  1206. sandbox.getBranchValues=function(o,p){try{
  1207. 	var ret={};
  1208. 	for(var i in o) {
  1209. 		//get value p for object o's element i
  1210. 		if (p=="id"){ //special case for fetching a list of ID's
  1211. 			if (exists(o[i][p])) ret[i]=o[i][p];
  1212. 			else ret[i]=i;
  1213. 		} else if (p=="."){ //special case for fetching a list of all objects without a tree structure
  1214. 			ret[i]=o[i];
  1215. 		}
  1216.  
  1217. 		else if (exists(o[i][p])) ret[i]=o[i][p];
  1218. 		//if object o has kids, then get all the values p inside that kid k
  1219. 		if (o[i].kids) ret=mergeJSON(ret,getBranchValues(o[i].kids,p));
  1220. 	}
  1221. 	return ret;
  1222. }catch(e){log("wmLibrary.getBranchValues: "+e);}};
  1223.  
  1224. //convert an object's methods to an array, storing the method's key on the object as an id
  1225. sandbox.methodsToArray = function(o) {try{var ret=[]; for (var i in o) {o[i].id=o[i].id||i; ret.push(o[i])}; return ret;}catch(e){log("wmLibrary.methodsToArray: "+e);}};
  1226.  
  1227. //convert an array of objects to methods of an object using either the object's ai or name as its key
  1228. sandbox.arrayToMethods = function(a) {try{var ret={}; for (var i=0;i<a.length;i++) ret[ a[i].id||a[i].name ]=a[i]; return ret;}catch(e){log("wmLibrary.arrayToMethods: "+e);}};
  1229.  
  1230. //convert an object's methods to an array of those method names
  1231. sandbox.methodNames = function(o) {try{var ret=[]; for (i in o) ret.push(i); return ret;}catch(e){log("wmLibrary.methodNames: "+e);}};
  1232.  
  1233. //copy parts from one object to another
  1234. //used for extending one object with parts from another
  1235. //by John Resig
  1236. sandbox.extend = function(a,b) {try{
  1237. 	for ( var i in b ) {
  1238. 		//collect setter/getter functions
  1239. 		var g = b.__lookupGetter__(i), s = b.__lookupSetter__(i);
  1240. 		//copy setter/getter functions
  1241. 		if ( g || s ) {
  1242. 			if ( g ) a.__defineGetter__(i, g);
  1243. 			if ( s ) a.__defineSetter__(i, s);
  1244. 		} else a[i] = b[i]; //copy vars
  1245. 	}
  1246. 	return a;
  1247. }catch(e){log("wmLibrary.extend: "+e);}};	
  1248.  
  1249. //***************************************************************************************************************************************
  1250. //***** WM Specific Functions
  1251. //***************************************************************************************************************************************
  1252.  
  1253. //returns an object suitable for accText data based on an array, and allowing an idPrefix and textSuffix
  1254. sandbox.createAccTextFromArray = function(arr,idPrefix,textSuffix){try{var ret={};if (arr) {for (var i=0,len=arr.length;i<len;i++){ret[(idPrefix||'')+arr[i].noSpaces().toLowerCase()]=arr[i].upperWords()+(textSuffix||'');}};return ret;}catch(e){log("wmLibrary.createAccTextFromArray: "+e);}};
  1255.  
  1256. //writes a message to the hash section of the document location, or redirects to a location that can accept a new hash section
  1257. sandbox.sendMessage=function(s,hwnd,flag){try{
  1258. 	hwnd = (hwnd||window.top);
  1259. 	if (exists(hwnd)) try {hwnd.location.hash = s;} catch(e){
  1260. 		if (flag==1) hwnd.location.href = "http://apps.facebook.com/?#"+s;
  1261. 		else hwnd.location.href = "http://www.facebook.com/reqs.php?#"+s;
  1262. 	}
  1263. }catch(e){log("wmLibrary.sendMessage: "+e);}};
  1264.  
  1265. //flags for menu building function
  1266. sandbox.MENU_ID_ENFORCE_NAME=1; //causes menuFromData to return lowercase nospace names as the id instead of the calculated id
  1267.  
  1268. //inserts one or more menu option blocks based upon a data object
  1269. //marking all new items in the newitem list above as green so users can easily find your changes
  1270. sandbox.menuFromData=function(data,menuNode,newItemList,idPrefix,flags){try{
  1271. 	flags=(flags||0); newItemList=(newItemList||[]);
  1272. 	if (data) for (var m=0,len=data.length; m<len; m++) {
  1273. 		var text = data[m]["name"].upperWords(), event = (data[m]["event"]||"Unsorted").upperWords();
  1274. 		var outid = (flags==MENU_ID_ENFORCE_NAME)?data[m].name.noSpaces().toLowerCase():(data[m]["id"]||data[m]["name"]).noSpaces().toLowerCase();
  1275. 		var thisMenu; if( !(thisMenu=(menuNode["optblock"+event]||null) ) ) {thisMenu=(menuNode["optblock"+event]={type:"optionblock",label:event,kids:{} });}
  1276. 		thisMenu.kids[idPrefix+outid]={type:"checkbox",label:text,newitem:newItemList.inArray(idPrefix+outid)};
  1277. 	}
  1278. }catch(e){log("wmLibrary.menuFromData: "+e);}};
  1279.  
  1280. //returns a list of search strings from a data object containing id's names and events, already optimized for searching
  1281. sandbox.searchFromData=function(data,idPrefix){try{
  1282. 	idPrefix=(idPrefix||""); 
  1283. 	var ret = []; 
  1284. 	for (var m=0,mat;(mat=data[m]);m++){
  1285. 		ret.push(idPrefix+(mat.id||mat.name));
  1286. 	} 
  1287. 	ret.optimize();
  1288. 	return ret;
  1289. }catch(e){log("wmLibrary.searchFromData: "+e);}};
  1290.  
  1291. //returns a list of materials from a data object containing id's names and events, already optimized for searching
  1292. sandbox.matListFromData=function(data){try{
  1293. 	var ret = []; 
  1294. 	for (var m=0,mat;(mat=data[m]);m++){
  1295. 		ret.push(mat.name);
  1296. 	} ret.optimize(); 
  1297. 	return ret;
  1298. }catch(e){log("wmLibrary.matListFromData: "+e);}};
  1299.  
  1300. //returns a valid accText object from a data object containing id's names and events
  1301. sandbox.accTextFromData=function(data,idPrefix,textSuffix,flags){try{idPrefix=(idPrefix||""); textSuffix=(textSuffix||"");var ret={}; for (var m=0,mat;(mat=data[m]);m++){ret[idPrefix+((flags==MENU_ID_ENFORCE_NAME)?mat.name:(mat.id||mat.name)).noSpaces().toLowerCase()]=(mat.name+textSuffix).upperWords();} return ret;}catch(e){log("wmLibrary.accTextFromData: "+e);}};
  1302.  
  1303. //***************************************************************************************************************************************
  1304. //***** Sidekick Object
  1305. //***************************************************************************************************************************************
  1306.  
  1307. //sidekick specific functions
  1308. sandbox.Sidekick={	
  1309. 	//init
  1310. 	tabID:null,
  1311. 	status:0,
  1312. 	nopopLink:"",
  1313.  
  1314. 	//attempts to dock the sidekick script to the wm host script
  1315. 	//params takes an object that contains the following parameters: 
  1316. 	//appID(string), version(string), skType(integer),
  1317. 	//name(string), thumbSource(string or array), 
  1318. 	//flags(object), icon(string), desc(string), 
  1319. 	//addFilters(object),
  1320. 	//alterLink(object), accText(object), 
  1321. 	//tests(array) and menu(object)
  1322. 	dock: function(params){try{
  1323. 		//find the dock node on this page
  1324. 		var door=$('wmDock');
  1325. 		if (!door) {
  1326. 			//does not exist, wait and try again later
  1327. 			window.setTimeout(function(){Sidekick.dock(params);}, 1000);
  1328. 			return;
  1329. 		} 
  1330. 		//detect if a sidekick for this app is already docked
  1331. 		var doorMark=$('wmDoor_app'+params.appID);
  1332. 		if (doorMark && (params.skType==doorMark.getAttribute("value")) ) {
  1333. 			//a sidekick of this level is already here, cancel docking
  1334. 			return;
  1335. 		}
  1336. 		
  1337. 		//setup defaults for a few of the expected parameters
  1338. 		params.thumbsSource=(params.thumbsSource||"app_full_proxy.php?app"+params.appID);
  1339. 		params.desc=(params.desc||params.name+" Sidekick (ver "+params.version+")");
  1340.  
  1341. 		//create a block of data to attach to the dock
  1342. 		var attString=JSON.stringify(params);
  1343. 		door.appendChild(
  1344. 			doorMark=createElement('div',{id:'wmDoor_app'+params.appID,'data-ft':attString,value:(params.skType||0)})
  1345. 		);
  1346. 		//doorMark.setAttribute("skType",(params.skType||0));
  1347. 		//confirm(doorMark.getAttribute("skType"));
  1348. 		
  1349. 		//ring the buzzer so the host knows the package is ready
  1350. 		window.setTimeout(function(){click(door);},1000);
  1351. 	}catch(e){log("wmLibrary.Sidekick.dock: "+e);}},
  1352. 	
  1353. 	
  1354. 	//receive and process messages
  1355. 	//msg code 1 is a packet from the wm host containing data about the post we are processing
  1356. 	//that packet must contain at least the tab/window ID with which the WM host can access that tab again
  1357. 	//msg code 3 is a packet from this or a deeper iframe window about the return value for this post
  1358. 	
  1359. 	//because Chrome returns NULL at event.source on msg 1, we now have to rethink
  1360. 	receiveMessage: function(event) {try{
  1361. 		if (isObject(event.data)) {
  1362. 			var data=event.data; //just shorten the typing
  1363. 			if (data.channel=="WallManager"){
  1364. 				log(JSON.stringify(data));
  1365. 				
  1366. 				switch (data.msg) {
  1367. 					case 1: //get init data from wm host
  1368. 						//if (!Sidekick.tabID) 
  1369. 							Sidekick.tabID=data.tabID;
  1370. 							log("Sidekick hears host...");
  1371. 						//
  1372. 						break;
  1373. 					case 3: //get message from child
  1374. 						if (Sidekick.tabID) {
  1375. 							log("Sidekick hears iframe...");
  1376. 							//send our status packet back to wm
  1377. 							Sidekick.status=data.status;
  1378. 							Sidekick.nopopLink=data.nopopLink||null;
  1379. 							//update the stored data about this post
  1380. 							var skChannel = getOptJSON("skChannel")||{};
  1381. 							skChannel[Sidekick.tabID]={
  1382. 								tabID:Sidekick.tabID,
  1383. 								status:Sidekick.status,
  1384. 								nopopLink:Sidekick.nopopLink,
  1385. 							};
  1386. 							log(JSON.stringify(skChannel));
  1387. 							setOptJSON("skChannel",skChannel);
  1388. 						} else {
  1389. 							//have not yet recieved tabID package from wm, wait a sec
  1390. 							setTimeout(function(){Sidekick.receiveMessage(event);},1000);
  1391. 						}
  1392. 						break;
  1393. 				}
  1394. 			}
  1395. 		}
  1396. 	}catch(e){log("wmLibrary.Sidekick.receiveMessage: "+e);}},
  1397.  
  1398. 	//disable the listener started below
  1399. 	unlisten: function(params){try{
  1400. 		window.removeEventListener("message", Sidekick.receiveMessage, false);
  1401. 	}catch(e){log("wmLibrary.Sidekick.unlisten: "+e);}},
  1402. 	
  1403. 	//turn on the listener which can receive messages from wm host (if this window = window.top) or from iframes
  1404. 	listen: function(params){try{
  1405. 		window.addEventListener("message", Sidekick.receiveMessage, false);
  1406. 	}catch(e){log("wmLibrary.Sidekick.listen: "+e);}},
  1407.  
  1408. 	//listen for changes to the skChannel variable and report those changes to WM whenever docked
  1409. 	openChannel: function(){try{
  1410. 		var dump=$("wmDataDump");
  1411. 		if (dump) {
  1412. 			var skData=getOpt("skChannel");
  1413. 			setOpt("skChannel","");
  1414. 			if (skData) dump.appendChild(createElement('div',{'data-ft':skData}));
  1415. 		}
  1416. 		setTimeout(Sidekick.openChannel,1000);
  1417. 	}catch(e){log("wmLibrary.Sidekick.openChannel: "+e);}},
  1418.  
  1419. 	//send a status code from the deepest iframe to the topmost frame so that it can be passed back with data the top window already has
  1420. 	sendStatus: function(status,link){try{
  1421. 		if (exists(window.top)) {
  1422. 			window.top.postMessage({
  1423. 				channel:"WallManager",
  1424. 				msg:3,
  1425. 				status:status,
  1426. 				nopopLink:(link?link:''),
  1427. 			},"*");
  1428. 		} else {
  1429. 			//window.top is hidden to us from this location
  1430. 			contentEval('window.top.postMessage({"channel":"WallManager","msg":3,"status":'+status+',"link":"'+(link?link:'')+'"},"*");');
  1431. 		}	
  1432. 	}catch(e){log("wmLibrary.Sidekick.sendStatus: "+e);}},
  1433. };
  1434.  
  1435. //***************************************************************************************************************************************
  1436. //***** Visual Effects
  1437. //***************************************************************************************************************************************
  1438.  
  1439. //slides element e toward the specified destination offset
  1440. //specify [t, l, r, b] top, left, right, and bottom as the final offset
  1441. //specify s as the number of MS the move should loop on
  1442. //specify p as the number of pixels to move per interval
  1443. sandbox.slide=function(e,t,l,r,b,s,p) {try{
  1444. 	s=s||50;p=p||10;
  1445.  
  1446. 	var top= e.style.top; top=parseInt(top); top=(isNaN(top))?0:top;
  1447. 	var bottom = e.style.bottom; bottom=parseInt(bottom); bottom=(isNaN(bottom))?0:bottom;
  1448. 	var left= e.style.left; left=parseInt(left); left=(isNaN(left))?0:left;
  1449. 	var right = e.style.right; right=parseInt(right); right=(isNaN(right))?0:right;
  1450.  
  1451. 	p1=(p>Math.abs(t))?Math.abs(t):p;
  1452. 	if(t>0) {e.style.top = (top+p1)+"px";t-=p1;}
  1453. 	else if (t<0) {e.style.top = (top-p1)+"px";t+=p1;}
  1454.  
  1455. 	p1=(p>Math.abs(l))?Math.abs(l):p;
  1456. 	if(l>0) {e.style.left = (left+p1)+"px";l-=p1;}
  1457. 	else if (l<0) {e.style.left = (left-p1)+"px";l+=p1;}
  1458.  
  1459. 	p1=(p>Math.abs(r))?Math.abs(r):p;
  1460. 	if(r>0) {e.style.right = (right+p1)+"px";r-=p1;}
  1461. 	else if (r<0) {e.style.right = (right-p1)+"px";r+=p1;}
  1462.  
  1463. 	p1=(p>Math.abs(b))?Math.abs(b):p;
  1464. 	if(b>0) {e.style.bottom = (bottom+p1)+"px";b-=p1;}
  1465. 	else if (b<0) {e.style.bottom = (bottom-p1)+"px";b+=p1;}
  1466.  
  1467. 	if (t!=0||l!=0||r!=0||b!=0) window.setTimeout(function(){slide(e,t,l,r,b,s,p);},s);
  1468. }catch(e){log("wmLibrary.slide: "+e);}};
  1469.  
  1470. //***************************************************************************************************************************************
  1471. //***** URL Encode/Decode
  1472. //***************************************************************************************************************************************
  1473.  
  1474. //url encode/decode functions nicely wrapped from webtoolkit
  1475. sandbox.Url = {
  1476. 	// public method for url encoding
  1477. 	encode : function (string) {try{return escape(this._utf8_encode(string));}catch(e){log("wmLibrary.Url.encode: "+e);}},
  1478.  
  1479. 	// public method for url decoding
  1480. 	decode : function (string) {try{return this._utf8_decode(unescape(string));}catch(e){log("wmLibrary.Url.decode: "+e);}},
  1481.  
  1482. 	// private method for UTF-8 encoding
  1483. 	_utf8_encode : function (string) {
  1484. 		string = string.replace(/\r\n/g,"\n");
  1485. 		var utftext = "";
  1486. 		for (var n = 0; n < string.length; n++) {
  1487. 			var c = string.charCodeAt(n);
  1488.  
  1489. 			if (c < 128) {
  1490. 				utftext += String.fromCharCode(c);
  1491. 			}
  1492. 			else if((c > 127) && (c < 2048)) {
  1493. 				utftext += String.fromCharCode((c >> 6) | 192);
  1494. 				utftext += String.fromCharCode((c & 63) | 128);
  1495. 			}
  1496. 			else {
  1497. 				utftext += String.fromCharCode((c >> 12) | 224);
  1498. 				utftext += String.fromCharCode(((c >> 6) & 63) | 128);
  1499. 				utftext += String.fromCharCode((c & 63) | 128);
  1500. 			}
  1501. 		}
  1502. 		return utftext;
  1503. 	},
  1504.  
  1505. 	// private method for UTF-8 decoding
  1506. 	_utf8_decode : function (utftext) {
  1507. 		var string = "";
  1508. 		var i = 0;
  1509. 		var c = c1 = c2 = 0;
  1510. 		while ( i < utftext.length ) {
  1511. 			c = utftext.charCodeAt(i);
  1512. 			if (c < 128) {
  1513. 				string += String.fromCharCode(c);
  1514. 				i++;
  1515. 			}
  1516. 			else if((c > 191) && (c < 224)) {
  1517. 				c2 = utftext.charCodeAt(i+1);
  1518. 				string += String.fromCharCode(((c & 31) << 6) | (c2 & 63));
  1519. 				i += 2;
  1520. 			}
  1521. 			else {
  1522. 				c2 = utftext.charCodeAt(i+1);
  1523. 				c3 = utftext.charCodeAt(i+2);
  1524. 				string += String.fromCharCode(((c & 15) << 12) | ((c2 & 63) << 6) | (c3 & 63));
  1525. 				i += 3;
  1526. 			} 
  1527. 		}
  1528. 		return string;
  1529. 	}
  1530. };
  1531.  
  1532. //***************************************************************************************************************************************
  1533. //***** GM Local Storage Commands
  1534. //***************************************************************************************************************************************
  1535.  
  1536. // set an option
  1537. sandbox.setOpt=function(opt,value){try{GM_setValue(opt,value);}catch(e){log("wmLibrary.setOpt: "+e);}}
  1538.  
  1539. // Get a stored option
  1540. sandbox.getOpt=function(opt){try{return GM_getValue(opt);}catch(e){log("wmLibrary.getOpt: "+e);}}
  1541.  
  1542. // set an option
  1543. sandbox.setOptJSON=function(opt,value){try{GM_setValue(opt,JSON.stringify(value));}catch(e){log("wmLibrary.setOptJSON: "+e);}}
  1544.  
  1545. // Get a stored option
  1546. sandbox.getOptJSON=function(opt){try{var v=GM_getValue(opt, '{}');return JSON.parse(v);}catch(e){log("wmLibrary.getOptJSON: "+e+" opt is:"+opt+", data is:"+v);}}
  1547.  
  1548.  
  1549. //***************************************************************************************************************************************
  1550. //***** 2D Math
  1551. //***************************************************************************************************************************************
  1552.  
  1553. // add two points or vectors
  1554. sandbox.addPoints = function(p0, p1){try{
  1555. 	var p2=mergeJSON(p0); //copy p0
  1556. 	for (var v in p1) p2[v]=(p2[v]||0)+(p1[v]||0);
  1557. 	return p2;
  1558. }catch(e){log("wmLibrary.addPoints: "+e);}},
  1559.  
  1560. //***************************************************************************************************************************************
  1561. //***** Delays and Repeaters
  1562. //***************************************************************************************************************************************
  1563.  
  1564. // shortform for window.setTimeout(x,0)
  1565. sandbox.doAction = function(f) {try{setTimeout(f,0);}catch(e){log("doAction: "+e);}};
  1566.  
  1567. //repeat a function fn a number of times n with a delay of 1 second between calls
  1568. sandbox.signal = function(fn,n){try{
  1569. 	if (n>0) {
  1570. 		doAction(fn);
  1571. 		setTimeout(function(){signal(fn,n-1);},1000);
  1572. 	}
  1573. }catch(e){log("wmLibrary.signal: "+e);}};
  1574.  
  1575. //***************************************************************************************************************************************
  1576. //***** Enum Creation
  1577. //***************************************************************************************************************************************
  1578.  
  1579. // create an unprotected enumeration list
  1580. sandbox.Enum = function() {try{for (var i in arguments) {this[arguments[i]] = i;}}catch(e){log("Enum.init: "+e);}};
  1581.  
  1582. //create an unprotected enumeration list of binary flags
  1583. sandbox.EnumFlags = function() {try{for (var i in arguments) {this[arguments[i]] = Math.pow(2,i);}}catch(e){log("EnumFlags.init: "+e);}};
  1584.  
  1585. //***************************************************************************************************************************************
  1586. //***** Pop-ups
  1587. //***************************************************************************************************************************************
  1588.  
  1589. //create a centered iframe to display multiline text in a textarea
  1590. //with optional isJSON flag which will format JSON strings with indents and linebreaks
  1591. sandbox.promptText = function(s,isJSON){try{
  1592. 	if (isJSON) s=s.formatJSON(4);
  1593. 	var newFrame;
  1594. 	document.body.appendChild((newFrame=createElement('iframe',{style:'position:fixed; top:0; left:0; display:none !important; z-index:999; width:75%; height:75%; max-height:95%; max-width:95%; border:1px solid #000000; overflow:auto; background-color:white;'})));
  1595. 	newFrame.src = 'about:blank'; // In WebKit src cant be set until it is added to the page
  1596. 	newFrame.addEventListener('load', function(){
  1597. 		var frameBody = this.contentDocument.getElementsByTagName('body')[0];
  1598. 		
  1599. 		var close=function(){try{
  1600. 			remove(newFrame);
  1601. 			delete newFrame;
  1602. 		}catch(e){log("wmLibrary.promptText.close: "+e);}};
  1603. 		
  1604. 		// Add save and close buttons
  1605. 		frameBody.appendChild(
  1606. 			createElement("textArea",{textContent:s,style:"height:90%;width:100%;"})
  1607. 		);
  1608. 		frameBody.appendChild(
  1609. 			createElement("div", {id:"buttons_holder"}, [
  1610. 				createElement('button',{id:"closeBtn", textContent:"Close",title:"Close window",onclick:close}),
  1611. 			])
  1612. 		);
  1613. 		
  1614. 		var center=function(){try{
  1615. 			var style=newFrame.style;
  1616. 			var node=newFrame;
  1617. 			style.display = '';
  1618. 			style.top = Math.floor((window.innerHeight/2)-(node.offsetHeight/2)) + 'px';
  1619. 			style.left = Math.floor((window.innerWidth/2)-(node.offsetWidth/2)) + 'px';
  1620. 		}catch(e){log("wmLibrary.promptText.center: "+e);}};
  1621. 		center();				
  1622. 		window.addEventListener('resize', center, false); // Center it on resize
  1623.  
  1624. 		// Close frame on window close
  1625. 		window.addEventListener('beforeunload', function(){newFrame.remove(this);}, false);
  1626. 		
  1627. 	}, false);
  1628. }catch(e){log("wmLibrary.promptText: "+e);}};
  1629.  
  1630. //***************************************************************************************************************************************
  1631. //***** Text To Script
  1632. //***************************************************************************************************************************************
  1633.  
  1634. //force code to be run outside the GM sandbox
  1635. sandbox.contentEval = function(source) {try{
  1636. 	// Check for function input.
  1637. 	if ('function' == typeof source) {
  1638. 	// Execute this function with no arguments, by adding parentheses.
  1639. 	// One set around the function, required for valid syntax, and a
  1640. 	// second empty set calls the surrounded function.
  1641. 		source = '(' + source + ')();'
  1642. 	}
  1643.  
  1644. 	// Create a script node holding this  source code.
  1645. 	var script = document.createElement('script');
  1646. 	script.setAttribute("type", "application/javascript");
  1647. 	script.textContent = source;
  1648.  
  1649. 	// Insert the script node into the page, so it will run, and immediately
  1650. 	// remove it to clean up.
  1651. 	document.body.appendChild(script);
  1652. 	document.body.removeChild(script);
  1653. }catch(e){log("wmLibrary.contentEval: "+e);}};
  1654.  
  1655. //***************************************************************************************************************************************
  1656. //***** RegExp Construction
  1657. //***************************************************************************************************************************************
  1658.  
  1659. //convert an array to a pipe delimited RegExp group
  1660. sandbox.arrayToRegExp = function(a) {try{
  1661. 	var ret="";
  1662. 	if (isArrayAndNotEmpty(a)) {
  1663. 		ret="(";
  1664. 		for (var i=0,len=a.length; i<len;i++){
  1665. 			ret=ret+a[i];
  1666. 			if (i<(len-1)) ret=ret+"|";
  1667. 		}
  1668. 		ret=ret+")";
  1669. 	}
  1670. 	return ret;
  1671. }catch(e){log("wmLibrary.arrayToRegExp: "+e);}};
  1672.  
  1673. //takes an integer range and converts it to a regular expression
  1674. //which can search for that number range in a string
  1675. sandbox.integerRangeToRegExp = function(params) {try{
  1676. 	params=params||{};
  1677. 	var min=params.min.toString(), max=params.max.toString();
  1678. 	var ret="";
  1679.  
  1680. 	//on the odd case that both min and max values were equal
  1681. 	if (max==min) return max;
  1682. 		
  1683. 	//count shared digits we can omit from complex regexp
  1684. 	var numSharedDigits=0;
  1685. 	if (min.length==max.length) {
  1686. 		for (var n=max.length;n>0;n--){
  1687. 			if (max.substring(0,n) == min.substring(0,n)) {
  1688. 				numSharedDigits=n;
  1689. 				break;
  1690. 			}
  1691. 		}
  1692. 	}
  1693. 	var shared=max.substring(0,numSharedDigits);
  1694. 		
  1695. 	//crop the min and max values
  1696. 	min=min.removePrefix(shared);
  1697. 	max=max.removePrefix(shared);
  1698.  
  1699. 	//move the shared stuff to the front of the test
  1700. 	ret+=shared+"(";
  1701.  
  1702. 	//count the digits
  1703. 	var minDigits=min.length;
  1704. 	var maxDigits=max.length;
  1705.  
  1706. 	//set some flags
  1707. 	var isSingleDigit=(minDigits==1 && maxDigits==1);
  1708. 	var isVariableDigits=(minDigits != maxDigits);
  1709. 	
  1710. 	//using 1 to 4444 as a range
  1711. 	//calculate maximum range tests
  1712. 	//ie: 444x 44xx 4xxx
  1713. 	if (maxDigits>1){
  1714. 		ret+=max.substr(0,maxDigits-1)+"[0-"+max.substr(maxDigits-1,1)+"]";
  1715. 		for (var n=(maxDigits-2); n>0; n--) {
  1716. 			if (max.substr(n,1)!="0") {
  1717. 				ret+="|"+max.substr(0,n)+"[0-"+(val(max.substr(n,1))-1)+"]"+("\\d").repeat((maxDigits-1)-n);
  1718. 			}
  1719. 		}
  1720. 	}
  1721.  
  1722. 	//calculate intermediate range tests
  1723. 	//ie: 1xxx, 1xx, 1x
  1724. 	for (var n=maxDigits;n>1;n--){
  1725. 		//check if min and max both use this digit
  1726. 		if (minDigits==n && maxDigits==n) {
  1727. 			//as neither bound would be put out of range
  1728. 			//and the bounds are not equal
  1729. 			if ((min.substr(0,1)!="9") && (max.substr(0,1)!="1") && (val(max.substr(0,1))>(val(min.substr(0,1))+1))) {
  1730. 				ret+="|["+(val(min.substr(0,1))+1)+"-"+(val(max.substr(0,1))-1)+"]"+("\\d").repeat(n-1);
  1731. 			}
  1732. 		//detect if min uses this digit
  1733. 		} else if (minDigits==n) {
  1734. 			//as long as it does not start with 9
  1735. 			if (min.substr(0,1)!="9") {
  1736. 				ret+="|["+(val(min.substr(0,1))+1)+"-9]"+("\\d").repeat(n-1);
  1737. 			}
  1738. 			break;
  1739. 		//detect if max uses this digit
  1740. 		} else if (maxDigits==n) {
  1741. 			//as long as it does not start with 1
  1742. 			if (max.substr(0,1)!="1") {
  1743. 				ret+="|[1-"+(val(max.substr(0,1))-1)+"]"+("\\d").repeat(n-1);
  1744. 			}
  1745. 		} else {
  1746. 			//they do not use this digit
  1747. 			//is it BETWEEN their digit counts
  1748. 			if (n > minDigits) {
  1749. 				ret+="|[1-9]"+("\\d").repeat(n-1);
  1750. 			}
  1751. 		}
  1752. 	}
  1753. 			
  1754. 	//calculate minimum range tests
  1755. 	//ie: [1-9]
  1756. 	if (minDigits>1){
  1757. 		ret+="|"+min.substr(0,minDigits-1)+"["+min.substr(minDigits-1,1)+"-9]";
  1758. 		for (var n=(minDigits-2); n>0; n--) {
  1759. 			if (min.substr(n,1)!="9") {
  1760. 				ret+="|"+min.substr(0,n)+"["+(val(min.substr(n,1))+1)+"-9]"+("[0-9]").repeat((minDigits-1)-n);
  1761. 			}
  1762. 		}
  1763. 	} else {
  1764. 		//single digit min
  1765. 		if (maxDigits>minDigits) {
  1766. 			ret+="|["+min+"-9]";
  1767. 		} else {
  1768. 			//both min and max are single digits
  1769. 			ret+="|["+min+"-"+max+"]";
  1770. 		}
  1771. 	}
  1772. 	
  1773. 	//fix same start and end range issues
  1774. 	for (var i=0;i<=9;i++){
  1775. 		ret=ret.replace(new RegExp("\\["+i+"-"+i+"\\]","gi"),i);
  1776. 	}
  1777. 	ret=ret.replace(new RegExp("\\[0-9\\]","gi"),"\\d");
  1778. 	
  1779. 	return ret+")";
  1780. }catch(e){log("wmLibrary.integerRangeToRegExp: "+e);}};
  1781.  
  1782. //***************************************************************************************************************************************
  1783. //***** Typing Simulation
  1784. //***************************************************************************************************************************************
  1785.  
  1786. sandbox.simulateKeyEvent = function(character,byCode) {
  1787.   var evt = document.createEvent("KeyboardEvent");
  1788.   (evt.initKeyEvent || evt.initKeyboardEvent)("keypress", true, true, window,
  1789.                     0, 0, 0, 0,
  1790.                     0, ((byCode||null) || character.charCodeAt(0)) ) 
  1791.   var canceled = !body.dispatchEvent(evt);
  1792.   if(canceled) {
  1793.     // A handler called preventDefault
  1794.     alert("canceled");
  1795.   } else {
  1796.     // None of the handlers called preventDefault
  1797.     alert("not canceled");
  1798.   }
  1799. };
  1800.  
  1801. sandbox.typeText = function(s) {
  1802. 	for (var i=0,len=s.length; i<len; i++){
  1803. 		simulateKeyEvent(s.substr(i,1));
  1804. 		log(s.substr(i,1));
  1805. 	}
  1806. };
  1807.  
  1808. sandbox.typeEnter = function() {
  1809. 	simulateKeyEvent(null,13);
  1810. };
  1811.  
  1812. /*formatting notes
  1813. format a number to x decimal places
  1814. number.toFixed(x);
  1815.  
  1816. convert to hexidecimal
  1817. number.toString(16);
  1818.  
  1819. //try something like this to get your own header details
  1820. define your own parseHeaders function
  1821. var fileMETA = parseHeaders(<><![CDATA[
  1822. // ==UserScript==
  1823. // @name          My Script
  1824. // @namespace     http://www.example.com/gmscripts
  1825. // @description   Scripting is fun
  1826. // @copyright     2009+, John Doe (http://www.example.com/~jdoe)
  1827. // @license       GPL version 3 or any later version; http://www.gnu.org/copyleft/gpl.html
  1828. // @version       0.0.1
  1829. // @include       http://www.example.com/*
  1830. // @include       http://www.example.org/*
  1831. // @exclude       http://www.example.org/foo
  1832. // @require       foo.js
  1833. // @resource      resourceName1 resource1.png
  1834. // @resource      resourceName2 http://www.example.com/resource2.png
  1835. // @uso:script    scriptid
  1836. // ==/UserScript==
  1837. ]]></>.toString());
  1838.  
  1839. //include jquery stuff
  1840. // ==UserScript==
  1841. // @name          jQuery Example
  1842. // @require       http://ajax.googleapis.com/ajax/libs/jquery/1.3.2/jquery.min.js
  1843. // ==/UserScript==
  1844. */
  1845.  
  1846. //a custom collection wrapper
  1847. //this pretty much mimics collections in visual basic
  1848. //with a lot of collection methods added from other systems
  1849. var jsCollection=function(objOrArray){
  1850. 	var self=this;
  1851. 	this.items={};
  1852. 	
  1853. 	//return an item from this collection by index or key
  1854. 	this.__defineGetter__("item",function(indexOrKey){try{
  1855. 		return this.items[indexOrKey]||null;
  1856. 	}catch(e){log("jsCollection.item: "+e);}});
  1857.  
  1858. 	//return the count of items in this collection
  1859. 	this.__defineGetter__("count",function(){try{
  1860. 		var ret=0;
  1861. 		for (var e in this.items) ret++;
  1862. 		return ret;
  1863. 	}catch(e){log("jsCollection.count: "+e);}});
  1864. 	
  1865. 	//return true if the count of items in this collection is 0
  1866. 	this.__defineGetter__("isEmpty",function(){try{
  1867. 		return this.count==0;
  1868. 	}catch(e){log("jsCollection.isEmpty: "+e);}});
  1869.  
  1870. 	//remove all items from this collection
  1871. 	this.clear=function(){try{
  1872. 		while(this.items[0]) delete this.items[0];
  1873. 	}catch(e){log("jsCollection.clear: "+e);}};
  1874. 	
  1875. 	//return the index of the first occurence of obj
  1876. 	this.indexOf=function(obj){try{
  1877. 		var c=0;
  1878. 		for (var i in this.items){
  1879. 			if (this.items[i]===obj) {
  1880. 				return c;
  1881. 				break;
  1882. 			}
  1883. 			c++;
  1884. 		}
  1885. 		return -1;
  1886. 	}catch(e){log("jsCollection.indexOf: "+e);}};
  1887.  
  1888. 	//return the key of the first occurence of obj
  1889. 	this.keyOf=function(obj){try{
  1890. 		for (var i in this.items){
  1891. 			if (this.items[i]===obj) {
  1892. 				return i;
  1893. 				break;
  1894. 			}
  1895. 		}
  1896. 		return -1;
  1897. 	}catch(e){log("jsCollection.keyOf: "+e);}};
  1898.  
  1899. 	//returns true if obj occurs in this collection
  1900. 	this.contains=function(obj){try{
  1901. 		return this.indexOf(obj)!=-1;
  1902. 	}catch(e){log("jsCollection.contains: "+e);}};
  1903. 	
  1904. 	//returns true if an item in this collection has key = key
  1905. 	this.containsKey=function(key){try{
  1906. 		return exists(this.items[key]);
  1907. 	}catch(e){log("jsCollection.containsKey: "+e);}};
  1908.  
  1909. 	//remove an item from the collection by index or key
  1910. 	this.remove=function(indexOrKey){try{
  1911. 		delete this.items[indexOrKey];
  1912. 	}catch(e){log("jsCollection.remove: "+e);}};
  1913. 	
  1914. 	//add an item to the collection
  1915. 	//with optional key which defaults to unique()
  1916. 	//with optional before which is an object to match
  1917. 	//with optional after which is an object to match
  1918. 	this.add=function(item,key,before,after){try{
  1919. 		key=key||unique();
  1920. 		if (before && this.indexOf(before)!=-1) {
  1921. 			var ret={};
  1922. 			for (var i in this.items){
  1923. 				if (this.items[i]===before) {
  1924. 					ret[key]=item;
  1925. 				}
  1926. 				ret[i]=this.items[i];
  1927. 			}
  1928. 			this.items=ret;
  1929. 		} else if (after && this.indexOf(after)!=-1) {
  1930. 			var ret={};
  1931. 			for (var i in this.items){
  1932. 				ret[i]=this.items[i];
  1933. 				if (this.items[i]===after) {
  1934. 					ret[key]=item;	
  1935. 				}
  1936. 			}
  1937. 			this.items=ret;
  1938. 		} else {
  1939. 			this.items[key]=item;
  1940. 		}
  1941. 	}catch(e){log("jsCollection.add: "+e);}};
  1942. 	
  1943. 	//shortform to add an item
  1944. 	//after an item
  1945. 	//with optional key
  1946. 	this.insertAfter=function(item,after,key){try{
  1947. 		this.add(item,key,null,after);
  1948. 	}catch(e){log("jsCollection.insertAfter: "+e);}};		
  1949.  
  1950. 	//shortform to add an item
  1951. 	//before an item
  1952. 	//with optional key
  1953. 	this.insertBefore=function(item,before,key){try{
  1954. 		this.add(item,key,before,null);
  1955. 	}catch(e){log("jsCollection.insertBefore: "+e);}};		
  1956. 	
  1957. 	//shortform to add an item
  1958. 	//with optional key
  1959. 	this.append=function(item,key){try{
  1960. 		this.add(item,key);
  1961. 	}catch(e){log("jsCollection.append: "+e);}};			
  1962. 	
  1963. 	//shortform to add an item
  1964. 	//to the beginning of the collection
  1965. 	//with optional key
  1966. 	this.prepend=function(item,key){try{
  1967. 		this.add(item,key,(this.items[0]||null));
  1968. 	}catch(e){log("jsCollection.prepend: "+e);}};		
  1969.  
  1970. 	//add an array of items
  1971. 	//with optional before and after
  1972. 	this.addRange=function(itemArray,before,after){try{
  1973. 		if (before && this.indexOf(before)!=-1) {
  1974. 			var ret={};
  1975. 			for (var i in this.items){
  1976. 				if (this.items[i]===before) {
  1977. 					for (var a=0,len=itemArrayLength;a<len;a++){
  1978. 						ret[unique()]=itemArray[a];
  1979. 					}
  1980. 				}
  1981. 				ret[i]=this.items[i];
  1982. 			}
  1983. 			this.items=ret;
  1984. 		} else if (after && this.indexOf(after)!=-1) {
  1985. 			var ret={};
  1986. 			for (var i in this.items){
  1987. 				ret[i]=this.items[i];
  1988. 				if (this.items[i]===after) {
  1989. 					for (var a=0,len=itemArrayLength;a<len;a++){
  1990. 						ret[unique()]=itemArray[a];
  1991. 					}
  1992. 				}
  1993. 			}
  1994. 			this.items=ret;
  1995. 		} else {
  1996. 			for (var a=0,len=itemArrayLength;a<len;a++){
  1997. 				this.items[unique()]=itemArray[a];
  1998. 			}
  1999. 		}
  2000. 	}catch(e){log("jsCollection.addRange: "+e);}};		
  2001.  
  2002. 	//shortform to add an array of items
  2003. 	this.appendRange=function(itemArray){try{
  2004. 		this.addRange(itemArray);
  2005. 	}catch(e){log("jsCollection.appendRange: "+e);}};			
  2006. 	
  2007. 	//shortform to add an array of items
  2008. 	//to the beginning of the collection
  2009. 	this.prependRange=function(itemArray){try{
  2010. 		this.addRange(itemArray,(this.items[0]||null));
  2011. 	}catch(e){log("jsCollection.prependRange: "+e);}};	
  2012.  
  2013. 	//add a copy of item 
  2014. 	//with optional before or after
  2015. 	this.addCopy=function(item,before,after){try{
  2016. 		this.add(item,null,before,after);
  2017. 	}catch(e){log("jsCollection.addCopy: "+e);}};		
  2018.  
  2019. 	//add multiple copies of item
  2020. 	//with optional before and after
  2021. 	this.addCopies=function(item,count,before,after){try{
  2022. 		var ret=[];
  2023. 		for (var i=0;i<count;i++) ret.push(item);
  2024. 		this.addRange(item,before,after);
  2025. 	}catch(e){log("jsCollection.addCopies: "+e);}};		
  2026.  
  2027. 	//return the collection converted to an array
  2028. 	this.toArray=function(){try{
  2029. 		return methodsToArray(this.items);
  2030. 	}catch(e){log("jsCollection.toArray: "+e);}};
  2031.  
  2032. 	//return the index of item with key=key
  2033. 	this.indexOfKey=function(key){try{
  2034. 		return this.indexOf(this.items[key]||null);
  2035. 	}catch(e){log("jsCollection.indexOfKey: "+e);}};	
  2036. 	
  2037. 	//return the key of the item at index=index
  2038. 	this.keyOfIndex=function(index){try{
  2039. 		var c=0;
  2040. 		for (var i in this.items){
  2041. 			if (c==index) return i;
  2042. 			c++;
  2043. 		}
  2044. 	}catch(e){log("jsCollection.keyOfIndex: "+e);}};	
  2045.  
  2046. 	//use passed data on creation to create initial items
  2047. 	if (objOrArray){
  2048. 		if (isArrayAndNotEmpty(objOrArray)){
  2049. 			for (var i=0,len=objOrArray.length;i<len;i++){
  2050. 				this.add(objOrArray[i],i);
  2051. 			}
  2052. 		} else if (isObject(objOrArray)) {
  2053. 			for (var i in objOrArray){
  2054. 				this.items[i]=objOrArray[i];
  2055. 			}
  2056. 		}
  2057. 	}
  2058. 	
  2059. 	//return self for external use
  2060. 	return this;
  2061. };
  2062.  
  2063. })();