☰

WM Common Library

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

ეს სკრიპტი არ უნდა იყოს პირდაპირ დაინსტალირებული. ეს ბიბლიოთეკაა, სხვა სკრიპტებისთვის უნდა ჩართეთ მეტა-დირექტივაში // @require https://update.greatest.deepsurf.us/scripts/407/1284/WM%20Common%20Library.js. 

  1. // ==UserScript==
  2. // @name           	WM Common Library
  3. // @namespace           tempcommon
  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.1.2
  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 Object.prototype.toString.call(o)==="[object 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 so that words which contain another word in the array are placed before that other word
  878. //such as "pea" must come AFTER "peanut", and "great american race" must come BEFORE "american"
  879. //the sort is case-insensitive
  880. sandbox.Array.prototype.fixOrder = function(){
  881. 	var compareFunc = function(a,b){
  882. 		var s1=a.toLowerCase(), s2=b.toLowerCase();
  883. 		if (s1.contains(s2)) return -1; //when a contains b, a must come first
  884. 		else if (s2.contains(s1)) return 1 //when b contains a, b must come first
  885. 		else return 0; //no order change is required
  886. 	};
  887. 	this.sort(compareFunc);
  888. 	return this;
  889. };	
  890.  
  891. //alias for the previous function	
  892. sandbox.Array.prototype.optimize = sandbox.Array.prototype.fixOrder;
  893.  
  894. //returns a shallow copy of the calling array
  895. sandbox.Array.prototype.clone = function(){try{
  896. 	return this.slice(0);
  897. }catch(e){log("wmLibrary.Array.prototype.clone: "+e);}};
  898.  
  899. //reverses the elements of an array
  900. //with optional startIndex
  901. //and optional count which limits the reverse section
  902. //if startIndex+count is greater than the length of the array 
  903. //then only the available section is reversed
  904. //returns the calling array
  905. sandbox.Array.prototype.reverse = function(startIndex,count){try{
  906. 	startIndex=startIndex||0;
  907. 	if (startIndex>=this.length) {
  908. 		//log("wmLibrary.Array.prototype.reverse: Error: startIndex out of bounds");
  909. 		return -1;
  910. 	}
  911. 	if (exists(count) && count<1) {
  912. 		//log("wmLibrary.Array.prototype.reverse: Error: count is less than 1");
  913. 		return -1;
  914. 	}
  915. 	var endIndex=(exists(count))?startIndex+count:this.length-1;
  916. 	if (endIndex>this.length-1) endIndex=this.length-1;
  917. 	while (startIndex>endIndex){
  918. 		this.swap(startIndex,endIndex);
  919. 		startIndex++;
  920. 		endIndex--;
  921. 	}
  922. 	return this;
  923. }catch(e){log("wmLibrary.Array.prototype.reverse: "+e);}};
  924.  
  925. //sets a range of elements in the array to the defaultValue
  926. //returns the calling array
  927. sandbox.Array.prototype.clear = function(startIndex,count,defaultValue){try{
  928. 	if (count>0 && this.length>startIndex) {
  929. 		for (var i=startIndex,len=this.length; (i<len && i<(startIndex+count)); i++){
  930. 			this[i]=defaultValue;
  931. 		}
  932. 	}
  933. 	return this;
  934. }catch(e){log("wmLibrary.Array.prototype.clear: "+e);}};
  935.  
  936. //copies elements from this array to a destination destArray
  937. //starting in this array at sourceIndex
  938. //and pasting into the destArray at destIndex
  939. //where length is the number of elements to copy
  940. //pasting beyond the higher bounds of the destArray simply increases the array size
  941. //returns the calling array
  942. sandbox.Array.prototype.copy = function(sourceIndex,destArray,destIndex,length){try{
  943. 	if (!isArray(destArray)) {
  944. 		log("wmLibrary.Array.prototype.copy: Error: destArray is not an array");
  945. 		return this;
  946. 	}
  947. 	if (sourceIndex >= this.length) {
  948. 		//log("wmLibrary.Array.prototype.copy: Error: sourceIndex out of bounds");
  949. 		return this;
  950. 	}
  951. 	for (var i=0; i<length; i++){
  952. 		destArray[destIndex+i]=this[sourceIndex+i];
  953. 	}
  954. 	return this;
  955. }catch(e){log("wmLibrary.Array.prototype.copy: "+e);}};
  956.  
  957. //copies all elements from this array to a destination destArray
  958. //pasting into the destArray at destIndex
  959. //pasting beyond the higher bounds of the destArray simply increases the array size
  960. //returns the calling array
  961. sandbox.Array.prototype.copyTo = function(destArray,destIndex){try{
  962. 	if (!isArray(destArray)) {
  963. 		log("wmLibrary.Array.prototype.copyTo: Error: destArray is not an array");
  964. 		return this;
  965. 	}
  966. 	for (var i=0, len=this.length; i<len; i++){
  967. 		destArray[destIndex+i]=this[i];
  968. 	}
  969. 	return this;
  970. }catch(e){log("wmLibrary.Array.prototype.copyTo: "+e);}};
  971.  
  972. //returns an array containing elements from the current array where the element has parameter p equal to value v
  973. 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);}};
  974.  
  975. //returns the element matched by matchFunc, or null
  976. //with optional start index
  977. //and optional count to limit the number of searched elements
  978. sandbox.Array.prototype.find = function(matchFunc,startIndex,count) {try{
  979. 	startIndex=startIndex||0;
  980. 	if (startIndex>=this.length) {
  981. 		//log("wmLibrary.Array.prototype.find: Error: startIndex out of bounds");
  982. 		return null;
  983. 	}
  984. 	if (exists(count) && count<1) {
  985. 		//log("wmLibrary.Array.prototype.find: Error: count is less than 1");
  986. 		return null;
  987. 	}
  988. 	var c=0;
  989. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  990. 		c++;
  991. 		if (matchFunc(this[i])) {
  992. 			return this[i];
  993. 			break;
  994. 		}
  995. 	}
  996. 	return null;
  997. }catch(e){log("wmLibrary.Array.prototype.find: "+e);}};
  998.  
  999. //returns the index of element matched by matchFunc, or -1
  1000. //with optional startIndex
  1001. //and optional count which specifies the number of elements to check
  1002. sandbox.Array.prototype.findIndex = function(matchFunc,startIndex,count) {try{
  1003. 	startIndex=startIndex||0;
  1004. 	if (startIndex>=this.length) {
  1005. 		//log("wmLibrary.Array.prototype.findIndex: Error: startIndex out of bounds");
  1006. 		return -1;
  1007. 	}
  1008. 	if (exists(count) && count<1) {
  1009. 		//log("wmLibrary.Array.prototype.findIndex: Error: count is less than 1");
  1010. 		return -1;
  1011. 	}
  1012. 	var c=0;
  1013. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  1014. 		c++;
  1015. 		if (matchFunc(this[i])) {
  1016. 			return i;
  1017. 			break;
  1018. 		}
  1019. 	}
  1020. 	return -1;
  1021. }catch(e){log("wmLibrary.Array.prototype.findIndex: "+e);}};
  1022.  
  1023. //returns all elements matched by matchFunc, or null
  1024. //with optional start index
  1025. //and optional count to limit the number of elements searched
  1026. sandbox.Array.prototype.findAll = function(matchFunc,startIndex,count) {try{
  1027. 	startIndex=startIndex||0;
  1028. 	var ret=[];
  1029. 	if (startIndex>=this.length) {
  1030. 		//log("wmLibrary.Array.prototype.findAll: Error: startIndex out of bounds");
  1031. 		return null;
  1032. 	}
  1033. 	if (exists(count) && count<1) {
  1034. 		//log("wmLibrary.Array.prototype.findAll: Error: count is less than 1");
  1035. 		return null;
  1036. 	}
  1037. 	var c=0;
  1038. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  1039. 		c++;
  1040. 		if (matchFunc(this[i])) {
  1041. 			ret.push(this[i]);
  1042. 		}
  1043. 	}
  1044. 	return (isArrayAndNotEmpty(ret))?ret:null;
  1045. }catch(e){log("wmLibrary.Array.prototype.findAll: "+e);}};
  1046.  
  1047. //returns true if all elements in the array match the matchFunc
  1048. //with optional start index
  1049. //and optional count to limit the number of elements searched
  1050. sandbox.Array.prototype.trueForAll = function(matchFunc,startIndex,count) {try{
  1051. 	startIndex=startIndex||0;
  1052. 	if (startIndex>=this.length) {
  1053. 		//log("wmLibrary.Array.prototype.trueForAll: Error: startIndex out of bounds");
  1054. 		return false;
  1055. 	}
  1056. 	if (exists(count) && count<1) {
  1057. 		//log("wmLibrary.Array.prototype.trueForAll: Error: count is less than 1");
  1058. 		return false;
  1059. 	}
  1060. 	var c=0;
  1061. 	for (var i=startIndex,len=this.length; (i<len && (!exists(count) || (exists(count) && c<count))); i++){
  1062. 		c++;
  1063. 		if (!matchFunc(this[i])) {
  1064. 			return false;
  1065. 		}
  1066. 	}
  1067. 	return true;
  1068. }catch(e){log("wmLibrary.Array.prototype.trueForAll: "+e);}};
  1069.  
  1070. //returns true if array contains an element matched by the matchFunc
  1071. //with optional startIndex
  1072. //and optional count which specifies the number of elements to check
  1073. sandbox.Array.prototype.exists = function(matchFunc,startIndex,count) {try{
  1074. 	return this.findIndex(matchFunc,startIndex,count)!=-1;
  1075. }catch(e){log("wmLibrary.Array.prototype.exists: "+e);}};
  1076.  
  1077. //returns the last element matched by matchFunc, or null
  1078. //with optional start index
  1079. //and optional count to limit the number of searched elements
  1080. sandbox.Array.prototype.findLast = function(matchFunc,startIndex,count) {try{
  1081. 	startIndex=startIndex||0;
  1082. 	if (startIndex>=this.length) {
  1083. 		//log("wmLibrary.Array.prototype.findLast: Error: startIndex out of bounds");
  1084. 		return null;
  1085. 	}
  1086. 	if (exists(count) && count<1) {
  1087. 		//log("wmLibrary.Array.prototype.findLast: Error: count is less than 1");
  1088. 		return null;
  1089. 	}
  1090. 	var c=0;
  1091. 	for (var i=this.length; (i>=startIndex && (!exists(count) || (exists(count) && c<count))); i--){
  1092. 		c++;
  1093. 		if (matchFunc(this[i])) {
  1094. 			return this[i];
  1095. 			break;
  1096. 		}
  1097. 	}
  1098. 	return null;
  1099. }catch(e){log("wmLibrary.Array.prototype.findLast: "+e);}};
  1100.  
  1101. //returns the last element matched by matchFunc, or -1
  1102. //with optional start index
  1103. //and optional count which specifies the number of elements to check
  1104. sandbox.Array.prototype.findLastIndex = function(matchFunc,startIndex,count) {try{
  1105. 	startIndex=startIndex||0;
  1106. 	if (startIndex>=this.length) {
  1107. 		//log("wmLibrary.Array.prototype.findLastIndex: Error: startIndex out of bounds");
  1108. 		return -1;
  1109. 	}
  1110. 	if (exists(count) && count<1) {
  1111. 		//log("wmLibrary.Array.prototype.findLastIndex: Error: count is less than 1");
  1112. 		return -1;
  1113. 	}
  1114. 	var c=0;
  1115. 	for (var i=this.length; (i>=startIndex && (!exists(count) || (exists(count) && c<count))); i--){
  1116. 		c++;
  1117. 		if (matchFunc(this[i])) {
  1118. 			return i;
  1119. 			break;
  1120. 		}
  1121. 	}
  1122. 	return -1;
  1123. }catch(e){log("wmLibrary.Array.prototype.findLastIndex: "+e);}};
  1124.  
  1125. //***************************************************************************************************************************************
  1126. //***** JSON/OBJECT Construction and Matching
  1127. //***************************************************************************************************************************************
  1128.  
  1129. //returns the merge of any number of JSON objects passed as unnamed arguments
  1130. sandbox.mergeJSON_long = function(){try{
  1131. 	var ret = {}; 
  1132. 	//for each JSON object passed
  1133. 	for (var a=0,len=arguments.length;a<len;a++) {
  1134. 		//for each element in that object
  1135. 		for (var v in arguments[a]) {
  1136. 			if (!exists(ret[v])) {
  1137. 				//simply copy the element to the return value
  1138. 				ret[v] = arguments[a][v];
  1139. 			} else {
  1140. 				if ((typeof arguments[a][v])=="object") {
  1141. 					//merge the two elements, preserving tree structure
  1142. 					ret[v] = mergeJSON(ret[v], arguments[a][v]);
  1143. 				} else {
  1144. 					//overwrite simple variable
  1145. 					ret[v] = arguments[a][v];
  1146. 				}
  1147. 			}
  1148. 		}
  1149. 	}
  1150. 	//the problem here is that its way too recursive and jams firefox often
  1151. 	return ret; 
  1152. }catch(e){log("wmLibrary.mergeJSON: "+e);}};
  1153.  
  1154. sandbox.mergeJSON = function(){try{
  1155. 	var ret = {}; 
  1156. 	//for each JSON object passed
  1157. 	for (var a=0,len=arguments.length;a<len;a++) {
  1158. 		var o=arguments[a];
  1159. 		//for each element in that object
  1160. 		for (var v in o) {
  1161. 			//replace the initial element with that of the next
  1162. 			ret[v] = o[v];
  1163. 		}
  1164. 		//the problem here is that only the top level branches are preserved
  1165. 	}
  1166. 	return ret; 
  1167. }catch(e){log("wmLibrary.mergeJSON: "+e);}};
  1168.  
  1169. //returns all members of an array that have a specified parameter with a specified value
  1170. //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);}};
  1171. 	
  1172. //returns all members of an array that have a specified parameter with a specified value
  1173. //now accepts input of array or object
  1174. //can now specify output of array or object
  1175. sandbox.matchByParam=function(o,param,value,outputType){try{
  1176. 	if(!exists(outputType)) outputType="array";
  1177. 	var inputType=(isArray(o))?"array":((typeof o) == "object")?"object":"unknown";
  1178. 	
  1179. 	var ret=(outputType=="object")?{}:[]; //default to array on error
  1180.  
  1181. 	switch(inputType){
  1182. 		case "array": for (var i=0,e;(e=o[i]);i++){
  1183. 			switch(outputType){
  1184. 				case "array": if (e[param]==value) ret.push(e); break;
  1185. 				case "object": if (e[param]==value) ret[i]=e; break;
  1186. 			}
  1187. 		};break;
  1188.  
  1189. 		case "object": for (var i in o){
  1190. 			var e=o[i];
  1191. 			switch(outputType){
  1192. 				case "array": if (e[param]==value) ret.push(e); break;
  1193. 				case "object": if (e[param]==value) ret[i]=e; break;
  1194. 			}
  1195. 		};break;
  1196. 	}
  1197. 	return ret;
  1198. }catch(e){log("wmLibrary.matchByParam: "+e);}};
  1199.  
  1200. //sorts the methods of an object by method 'id' or method 'value'
  1201. //beware this may mangle some objects
  1202. sandbox.sortCollection=function(o,by){
  1203. 	var a=[];
  1204. 	for (var i in o){
  1205. 		a.push({id:i,value:o[i]});
  1206. 	}
  1207. 	a.sort(function(a,b){return a[by]>b[by];});
  1208. 	var ret={};
  1209. 	for (var i=0;i<a.length;i++){
  1210. 		ret[a[i].id]=a[i].value;
  1211. 	}
  1212. 	return ret;
  1213. };
  1214.  
  1215. // Collect all the values from parameter p in object o, traversing kids nodes
  1216. sandbox.getBranchValues=function(o,p){try{
  1217. 	var ret={};
  1218. 	for(var i in o) {
  1219. 		//get value p for object o's element i
  1220. 		if (p=="id"){ //special case for fetching a list of ID's
  1221. 			if (exists(o[i][p])) ret[i]=o[i][p];
  1222. 			else ret[i]=i;
  1223. 		} else if (p=="."){ //special case for fetching a list of all objects without a tree structure
  1224. 			ret[i]=o[i];
  1225. 		}
  1226.  
  1227. 		else if (exists(o[i][p])) ret[i]=o[i][p];
  1228. 		//if object o has kids, then get all the values p inside that kid k
  1229. 		if (o[i].kids) ret=mergeJSON(ret,getBranchValues(o[i].kids,p));
  1230. 	}
  1231. 	return ret;
  1232. }catch(e){log("wmLibrary.getBranchValues: "+e);}};
  1233.  
  1234. //convert an object's methods to an array, storing the method's key on the object as an id
  1235. 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);}};
  1236.  
  1237. //convert an array of objects to methods of an object using either the object's ai or name as its key
  1238. 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);}};
  1239.  
  1240. //convert an object's methods to an array of those method names
  1241. sandbox.methodNames = function(o) {try{var ret=[]; for (i in o) ret.push(i); return ret;}catch(e){log("wmLibrary.methodNames: "+e);}};
  1242.  
  1243. //copy parts from one object to another
  1244. //used for extending one object with parts from another
  1245. //by John Resig
  1246. sandbox.extend = function(a,b) {try{
  1247. 	for ( var i in b ) {
  1248. 		//collect setter/getter functions
  1249. 		var g = b.__lookupGetter__(i), s = b.__lookupSetter__(i);
  1250. 		//copy setter/getter functions
  1251. 		if ( g || s ) {
  1252. 			if ( g ) a.__defineGetter__(i, g);
  1253. 			if ( s ) a.__defineSetter__(i, s);
  1254. 		} else a[i] = b[i]; //copy vars
  1255. 	}
  1256. 	return a;
  1257. }catch(e){log("wmLibrary.extend: "+e);}};	
  1258.  
  1259. //***************************************************************************************************************************************
  1260. //***** WM Specific Functions
  1261. //***************************************************************************************************************************************
  1262.  
  1263. //returns an object suitable for accText data based on an array, and allowing an idPrefix and textSuffix
  1264. sandbox.createAccTextFromArray=function(arr,keyPrefix,textSuffix){
  1265. 	var ret={};
  1266. 	if (arr) {
  1267. 		for (var i=0,len=arr.length;i<len;i++){
  1268. 			o=arr[i];
  1269. 			ret[(keyPrefix||'')+o.noSpaces().toLowerCase()]=o.upperWords()+(textSuffix||'');
  1270. 		}
  1271. 	}
  1272. 	return ret;
  1273. };
  1274.  
  1275. 	
  1276. //writes a message to the hash section of the document location, or redirects to a location that can accept a new hash section
  1277. sandbox.sendMessage=function(s,hwnd,flag){try{
  1278. 	hwnd = (hwnd||window.top);
  1279. 	if (exists(hwnd)) try {hwnd.location.hash = s;} catch(e){
  1280. 		if (flag==1) hwnd.location.href = "http://apps.facebook.com/?#"+s;
  1281. 		else hwnd.location.href = "http://www.facebook.com/reqs.php?#"+s;
  1282. 	}
  1283. }catch(e){log("wmLibrary.sendMessage: "+e);}};
  1284.  
  1285. //flags for menu building function
  1286. sandbox.MENU_ID_ENFORCE_NAME=1; //causes menuFromData to return lowercase nospace names as the id instead of the calculated id
  1287.  
  1288. //inserts one or more menu option blocks based upon a data object
  1289. //marking all new items in the newitem list above as green so users can easily find your changes
  1290. sandbox.menuFromData=function(data,menuNode,newItemList,idPrefix,flags){try{
  1291. 	flags=(flags||0); newItemList=(newItemList||[]);
  1292. 	if (data) for (var m=0,len=data.length; m<len; m++) {
  1293. 		var text = data[m]["name"].upperWords(), event = (data[m]["event"]||"Unsorted").upperWords();
  1294. 		var outid = (flags==MENU_ID_ENFORCE_NAME)?data[m].name.noSpaces().toLowerCase():(data[m]["id"]||data[m]["name"]).noSpaces().toLowerCase();
  1295. 		var thisMenu; if( !(thisMenu=(menuNode["optblock"+event]||null) ) ) {thisMenu=(menuNode["optblock"+event]={type:"optionblock",label:event,kids:{} });}
  1296. 		thisMenu.kids[idPrefix+outid]={type:"checkbox",label:text,newitem:newItemList.inArray(idPrefix+outid)};
  1297. 	}
  1298. }catch(e){log("wmLibrary.menuFromData: "+e);}};
  1299.  
  1300. //returns a list of search strings from a data object containing id's names and events, already optimized for searching
  1301. sandbox.searchFromData=function(data,idPrefix){try{
  1302. 	idPrefix=(idPrefix||""); 
  1303. 	var ret = []; 
  1304. 	for (var m=0,mat;(mat=data[m]);m++){
  1305. 		ret.push(idPrefix+(mat.id||mat.name));
  1306. 	} 
  1307. 	ret.optimize();
  1308. 	return ret;
  1309. }catch(e){log("wmLibrary.searchFromData: "+e);}};
  1310.  
  1311. //returns a list of materials from a data object containing id's names and events, already optimized for searching
  1312. sandbox.matListFromData=function(data){try{
  1313. 	var ret = []; 
  1314. 	for (var m=0,mat;(mat=data[m]);m++){
  1315. 		ret.push(mat.name);
  1316. 	} ret.optimize(); 
  1317. 	return ret;
  1318. }catch(e){log("wmLibrary.matListFromData: "+e);}};
  1319.  
  1320. //returns a valid accText object from a data object containing id's names and events
  1321. 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);}};
  1322.  
  1323. //***************************************************************************************************************************************
  1324. //***** Sidekick Object
  1325. //***************************************************************************************************************************************
  1326.  
  1327. //sidekick specific functions
  1328. sandbox.Sidekick={	
  1329. 	//init
  1330. 	tabID:null,
  1331. 	status:0,
  1332. 	nopopLink:"",
  1333.  
  1334. 	//attempts to dock the sidekick script to the wm host script
  1335. 	//params takes an object that contains the following parameters: 
  1336. 	//appID(string), version(string), skType(integer),
  1337. 	//name(string), thumbSource(string or array), 
  1338. 	//flags(object), icon(string), desc(string), 
  1339. 	//addFilters(object),
  1340. 	//alterLink(object), accText(object), 
  1341. 	//tests(array) and menu(object)
  1342. 	dock: function(params){try{
  1343. 		//find the dock node on this page
  1344. 		var door=$('wmDock');
  1345. 		if (!door) {
  1346. 			//does not exist, wait and try again later
  1347. 			window.setTimeout(function(){Sidekick.dock(params);}, 1000);
  1348. 			return;
  1349. 		} 
  1350. 		//detect if a sidekick for this app is already docked
  1351. 		var doorMark=$('wmDoor_app'+params.appID);
  1352. 		if (doorMark && (params.skType==doorMark.getAttribute("value")) ) {
  1353. 			//a sidekick of this level is already here, cancel docking
  1354. 			return;
  1355. 		}
  1356. 		
  1357. 		//setup defaults for a few of the expected parameters
  1358. 		params.thumbsSource=(params.thumbsSource||"app_full_proxy.php?app"+params.appID);
  1359. 		params.desc=(params.desc||params.name+" Sidekick (ver "+params.version+")");
  1360.  
  1361. 		//create a block of data to attach to the dock
  1362. 		var attString=JSON.stringify(params);
  1363. 		door.appendChild(
  1364. 			doorMark=createElement('div',{id:'wmDoor_app'+params.appID,'data-ft':attString,value:(params.skType||0)})
  1365. 		);
  1366. 		//doorMark.setAttribute("skType",(params.skType||0));
  1367. 		//confirm(doorMark.getAttribute("skType"));
  1368. 		
  1369. 		//ring the buzzer so the host knows the package is ready
  1370. 		window.setTimeout(function(){click(door);},1000);
  1371. 	}catch(e){log("wmLibrary.Sidekick.dock: "+e);}},
  1372. 	
  1373. 	
  1374. 	//receive and process messages
  1375. 	//msg code 1 is a packet from the wm host containing data about the post we are processing
  1376. 	//that packet must contain at least the tab/window ID with which the WM host can access that tab again
  1377. 	//msg code 3 is a packet from this or a deeper iframe window about the return value for this post
  1378. 	
  1379. 	//because Chrome returns NULL at event.source on msg 1, we now have to rethink
  1380. 	receiveMessage: function(event) {try{
  1381. 		if (isObject(event.data)) {
  1382. 			var data=event.data; //just shorten the typing
  1383. 			if (data.channel=="WallManager"){
  1384. 				log(JSON.stringify(data));
  1385. 				
  1386. 				switch (data.msg) {
  1387. 					case 1: //get init data from wm host
  1388. 						//if (!Sidekick.tabID) 
  1389. 							Sidekick.tabID=data.tabID;
  1390. 							log("Sidekick hears host...");
  1391. 						//
  1392. 						break;
  1393. 					case 3: //get message from child
  1394. 						if (Sidekick.tabID) {
  1395. 							log("Sidekick hears iframe...");
  1396. 							//send our status packet back to wm
  1397. 							Sidekick.status=data.status;
  1398. 							Sidekick.nopopLink=data.nopopLink||null;
  1399. 							//update the stored data about this post
  1400. 							var skChannel = getOptJSON("skChannel")||{};
  1401. 							skChannel[Sidekick.tabID]={
  1402. 								tabID:Sidekick.tabID,
  1403. 								status:Sidekick.status,
  1404. 								nopopLink:Sidekick.nopopLink,
  1405. 							};
  1406. 							log(JSON.stringify(skChannel));
  1407. 							setOptJSON("skChannel",skChannel);
  1408. 						} else {
  1409. 							//have not yet recieved tabID package from wm, wait a sec
  1410. 							setTimeout(function(){Sidekick.receiveMessage(event);},1000);
  1411. 						}
  1412. 						break;
  1413. 				}
  1414. 			}
  1415. 		}
  1416. 	}catch(e){log("wmLibrary.Sidekick.receiveMessage: "+e);}},
  1417.  
  1418. 	//disable the listener started below
  1419. 	unlisten: function(params){try{
  1420. 		window.removeEventListener("message", Sidekick.receiveMessage, false);
  1421. 	}catch(e){log("wmLibrary.Sidekick.unlisten: "+e);}},
  1422. 	
  1423. 	//turn on the listener which can receive messages from wm host (if this window = window.top) or from iframes
  1424. 	listen: function(params){try{
  1425. 		window.addEventListener("message", Sidekick.receiveMessage, false);
  1426. 	}catch(e){log("wmLibrary.Sidekick.listen: "+e);}},
  1427.  
  1428. 	//listen for changes to the skChannel variable and report those changes to WM whenever docked
  1429. 	openChannel: function(){try{
  1430. 		var dump=$("wmDataDump");
  1431. 		if (dump) {
  1432. 			var skData=getOpt("skChannel");
  1433. 			setOpt("skChannel","");
  1434. 			if (skData) dump.appendChild(createElement('div',{'data-ft':skData}));
  1435. 		}
  1436. 		setTimeout(Sidekick.openChannel,1000);
  1437. 	}catch(e){log("wmLibrary.Sidekick.openChannel: "+e);}},
  1438.  
  1439. 	//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
  1440. 	sendStatus: function(status,link){try{
  1441. 		if (exists(window.top)) {
  1442. 			window.top.postMessage({
  1443. 				channel:"WallManager",
  1444. 				msg:3,
  1445. 				status:status,
  1446. 				nopopLink:(link?link:''),
  1447. 			},"*");
  1448. 		} else {
  1449. 			//window.top is hidden to us from this location
  1450. 			contentEval('window.top.postMessage({"channel":"WallManager","msg":3,"status":'+status+',"link":"'+(link?link:'')+'"},"*");');
  1451. 		}	
  1452. 	}catch(e){log("wmLibrary.Sidekick.sendStatus: "+e);}},
  1453. };
  1454.  
  1455. //***************************************************************************************************************************************
  1456. //***** Visual Effects
  1457. //***************************************************************************************************************************************
  1458.  
  1459. //slides element e toward the specified destination offset
  1460. //specify [t, l, r, b] top, left, right, and bottom as the final offset
  1461. //specify s as the number of MS the move should loop on
  1462. //specify p as the number of pixels to move per interval
  1463. sandbox.slide=function(e,t,l,r,b,s,p) {try{
  1464. 	s=s||50;p=p||10;
  1465.  
  1466. 	var top= e.style.top; top=parseInt(top); top=(isNaN(top))?0:top;
  1467. 	var bottom = e.style.bottom; bottom=parseInt(bottom); bottom=(isNaN(bottom))?0:bottom;
  1468. 	var left= e.style.left; left=parseInt(left); left=(isNaN(left))?0:left;
  1469. 	var right = e.style.right; right=parseInt(right); right=(isNaN(right))?0:right;
  1470.  
  1471. 	p1=(p>Math.abs(t))?Math.abs(t):p;
  1472. 	if(t>0) {e.style.top = (top+p1)+"px";t-=p1;}
  1473. 	else if (t<0) {e.style.top = (top-p1)+"px";t+=p1;}
  1474.  
  1475. 	p1=(p>Math.abs(l))?Math.abs(l):p;
  1476. 	if(l>0) {e.style.left = (left+p1)+"px";l-=p1;}
  1477. 	else if (l<0) {e.style.left = (left-p1)+"px";l+=p1;}
  1478.  
  1479. 	p1=(p>Math.abs(r))?Math.abs(r):p;
  1480. 	if(r>0) {e.style.right = (right+p1)+"px";r-=p1;}
  1481. 	else if (r<0) {e.style.right = (right-p1)+"px";r+=p1;}
  1482.  
  1483. 	p1=(p>Math.abs(b))?Math.abs(b):p;
  1484. 	if(b>0) {e.style.bottom = (bottom+p1)+"px";b-=p1;}
  1485. 	else if (b<0) {e.style.bottom = (bottom-p1)+"px";b+=p1;}
  1486.  
  1487. 	if (t!=0||l!=0||r!=0||b!=0) window.setTimeout(function(){slide(e,t,l,r,b,s,p);},s);
  1488. }catch(e){log("wmLibrary.slide: "+e);}};
  1489.  
  1490. //***************************************************************************************************************************************
  1491. //***** URL Encode/Decode
  1492. //***************************************************************************************************************************************
  1493.  
  1494. //url encode/decode functions nicely wrapped from webtoolkit
  1495. sandbox.Url = {
  1496. 	// public method for url encoding
  1497. 	encode : function (string) {try{return escape(this._utf8_encode(string));}catch(e){log("wmLibrary.Url.encode: "+e);}},
  1498.  
  1499. 	// public method for url decoding
  1500. 	decode : function (string) {try{return this._utf8_decode(unescape(string));}catch(e){log("wmLibrary.Url.decode: "+e);}},
  1501.  
  1502. 	// private method for UTF-8 encoding
  1503. 	_utf8_encode : function (string) {
  1504. 		string = string.replace(/\r\n/g,"\n");
  1505. 		var utftext = "";
  1506. 		for (var n = 0; n < string.length; n++) {
  1507. 			var c = string.charCodeAt(n);
  1508.  
  1509. 			if (c < 128) {
  1510. 				utftext += String.fromCharCode(c);
  1511. 			}
  1512. 			else if((c > 127) && (c < 2048)) {
  1513. 				utftext += String.fromCharCode((c >> 6) | 192);
  1514. 				utftext += String.fromCharCode((c & 63) | 128);
  1515. 			}
  1516. 			else {
  1517. 				utftext += String.fromCharCode((c >> 12) | 224);
  1518. 				utftext += String.fromCharCode(((c >> 6) & 63) | 128);
  1519. 				utftext += String.fromCharCode((c & 63) | 128);
  1520. 			}
  1521. 		}
  1522. 		return utftext;
  1523. 	},
  1524.  
  1525. 	// private method for UTF-8 decoding
  1526. 	_utf8_decode : function (utftext) {
  1527. 		var string = "";
  1528. 		var i = 0;
  1529. 		var c = c1 = c2 = 0;
  1530. 		while ( i < utftext.length ) {
  1531. 			c = utftext.charCodeAt(i);
  1532. 			if (c < 128) {
  1533. 				string += String.fromCharCode(c);
  1534. 				i++;
  1535. 			}
  1536. 			else if((c > 191) && (c < 224)) {
  1537. 				c2 = utftext.charCodeAt(i+1);
  1538. 				string += String.fromCharCode(((c & 31) << 6) | (c2 & 63));
  1539. 				i += 2;
  1540. 			}
  1541. 			else {
  1542. 				c2 = utftext.charCodeAt(i+1);
  1543. 				c3 = utftext.charCodeAt(i+2);
  1544. 				string += String.fromCharCode(((c & 15) << 12) | ((c2 & 63) << 6) | (c3 & 63));
  1545. 				i += 3;
  1546. 			} 
  1547. 		}
  1548. 		return string;
  1549. 	}
  1550. };
  1551.  
  1552. //***************************************************************************************************************************************
  1553. //***** GM Local Storage Commands
  1554. //***************************************************************************************************************************************
  1555.  
  1556. // set an option
  1557. sandbox.setOpt=function(opt,value){try{GM_setValue(opt,value);}catch(e){log("wmLibrary.setOpt: "+e);}}
  1558.  
  1559. // Get a stored option
  1560. sandbox.getOpt=function(opt){try{return GM_getValue(opt);}catch(e){log("wmLibrary.getOpt: "+e);}}
  1561.  
  1562. // set an option
  1563. sandbox.setOptJSON=function(opt,value){try{GM_setValue(opt,JSON.stringify(value));}catch(e){log("wmLibrary.setOptJSON: "+e);}}
  1564.  
  1565. // Get a stored option
  1566. 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);}}
  1567.  
  1568.  
  1569. //***************************************************************************************************************************************
  1570. //***** 2D Math
  1571. //***************************************************************************************************************************************
  1572.  
  1573. // add two points or vectors
  1574. sandbox.addPoints = function(p0, p1){try{
  1575. 	var p2=mergeJSON(p0); //copy p0
  1576. 	for (var v in p1) p2[v]=(p2[v]||0)+(p1[v]||0);
  1577. 	return p2;
  1578. }catch(e){log("wmLibrary.addPoints: "+e);}},
  1579.  
  1580. //***************************************************************************************************************************************
  1581. //***** Delays and Repeaters
  1582. //***************************************************************************************************************************************
  1583.  
  1584. // shortform for window.setTimeout(x,0)
  1585. sandbox.doAction = function(f) {try{setTimeout(f,0);}catch(e){log("doAction: "+e);}};
  1586.  
  1587. //repeat a function fn a number of times n with a delay of 1 second between calls
  1588. sandbox.signal = function(fn,n){try{
  1589. 	if (n>0) {
  1590. 		doAction(fn);
  1591. 		setTimeout(function(){signal(fn,n-1);},1000);
  1592. 	}
  1593. }catch(e){log("wmLibrary.signal: "+e);}};
  1594.  
  1595. //***************************************************************************************************************************************
  1596. //***** Enum Creation
  1597. //***************************************************************************************************************************************
  1598.  
  1599. // create an unprotected enumeration list
  1600. sandbox.Enum = function() {try{for (var i in arguments) {this[arguments[i]] = i;}}catch(e){log("Enum.init: "+e);}};
  1601.  
  1602. //create an unprotected enumeration list of binary flags
  1603. sandbox.EnumFlags = function() {try{for (var i in arguments) {this[arguments[i]] = Math.pow(2,i);}}catch(e){log("EnumFlags.init: "+e);}};
  1604.  
  1605. //***************************************************************************************************************************************
  1606. //***** Pop-ups
  1607. //***************************************************************************************************************************************
  1608.  
  1609. //create a centered iframe to display multiline text in a textarea
  1610. //with optional isJSON flag which will format JSON strings with indents and linebreaks
  1611. sandbox.promptText = function(s,isJSON){try{
  1612. 	if (isJSON) s=s.formatJSON(4);
  1613. 	var newFrame;
  1614. 	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;'})));
  1615. 	newFrame.src = 'about:blank'; // In WebKit src cant be set until it is added to the page
  1616. 	newFrame.addEventListener('load', function(){
  1617. 		var frameBody = this.contentDocument.getElementsByTagName('body')[0];
  1618. 		
  1619. 		var close=function(){try{
  1620. 			remove(newFrame);
  1621. 			delete newFrame;
  1622. 		}catch(e){log("wmLibrary.promptText.close: "+e);}};
  1623. 		
  1624. 		// Add save and close buttons
  1625. 		frameBody.appendChild(
  1626. 			createElement("textArea",{textContent:s,style:"height:90%;width:100%;"})
  1627. 		);
  1628. 		frameBody.appendChild(
  1629. 			createElement("div", {id:"buttons_holder"}, [
  1630. 				createElement('button',{id:"closeBtn", textContent:"Close",title:"Close window",onclick:close}),
  1631. 			])
  1632. 		);
  1633. 		
  1634. 		var center=function(){try{
  1635. 			var style=newFrame.style;
  1636. 			var node=newFrame;
  1637. 			style.display = '';
  1638. 			style.top = Math.floor((window.innerHeight/2)-(node.offsetHeight/2)) + 'px';
  1639. 			style.left = Math.floor((window.innerWidth/2)-(node.offsetWidth/2)) + 'px';
  1640. 		}catch(e){log("wmLibrary.promptText.center: "+e);}};
  1641. 		center();				
  1642. 		window.addEventListener('resize', center, false); // Center it on resize
  1643.  
  1644. 		// Close frame on window close
  1645. 		window.addEventListener('beforeunload', function(){newFrame.remove(this);}, false);
  1646. 		
  1647. 	}, false);
  1648. }catch(e){log("wmLibrary.promptText: "+e);}};
  1649.  
  1650. //***************************************************************************************************************************************
  1651. //***** Text To Script
  1652. //***************************************************************************************************************************************
  1653.  
  1654. //force code to be run outside the GM sandbox
  1655. sandbox.contentEval = function(source) {try{
  1656. 	// Check for function input.
  1657. 	if ('function' == typeof source) {
  1658. 	// Execute this function with no arguments, by adding parentheses.
  1659. 	// One set around the function, required for valid syntax, and a
  1660. 	// second empty set calls the surrounded function.
  1661. 		source = '(' + source + ')();'
  1662. 	}
  1663.  
  1664. 	// Create a script node holding this  source code.
  1665. 	var script = document.createElement('script');
  1666. 	script.setAttribute("type", "application/javascript");
  1667. 	script.textContent = source;
  1668.  
  1669. 	// Insert the script node into the page, so it will run, and immediately
  1670. 	// remove it to clean up.
  1671. 	document.body.appendChild(script);
  1672. 	document.body.removeChild(script);
  1673. }catch(e){log("wmLibrary.contentEval: "+e);}};
  1674.  
  1675. //***************************************************************************************************************************************
  1676. //***** RegExp Construction
  1677. //***************************************************************************************************************************************
  1678.  
  1679. //convert an array to a pipe delimited RegExp group
  1680. sandbox.arrayToRegExp = function(a) {try{
  1681. 	var ret="";
  1682. 	if (isArrayAndNotEmpty(a)) {
  1683. 		ret="(";
  1684. 		for (var i=0,len=a.length; i<len;i++){
  1685. 			ret=ret+a[i];
  1686. 			if (i<(len-1)) ret=ret+"|";
  1687. 		}
  1688. 		ret=ret+")";
  1689. 	}
  1690. 	return ret;
  1691. }catch(e){log("wmLibrary.arrayToRegExp: "+e);}};
  1692.  
  1693. //takes an integer range and converts it to a regular expression
  1694. //which can search for that number range in a string
  1695. sandbox.integerRangeToRegExp = function(params) {try{
  1696. 	params=params||{};
  1697. 	var min=params.min.toString(), max=params.max.toString();
  1698. 	var ret="";
  1699.  
  1700. 	//on the odd case that both min and max values were equal
  1701. 	if (max==min) return max;
  1702. 		
  1703. 	//count shared digits we can omit from complex regexp
  1704. 	var numSharedDigits=0;
  1705. 	if (min.length==max.length) {
  1706. 		for (var n=max.length;n>0;n--){
  1707. 			if (max.substring(0,n) == min.substring(0,n)) {
  1708. 				numSharedDigits=n;
  1709. 				break;
  1710. 			}
  1711. 		}
  1712. 	}
  1713. 	var shared=max.substring(0,numSharedDigits);
  1714. 		
  1715. 	//crop the min and max values
  1716. 	min=min.removePrefix(shared);
  1717. 	max=max.removePrefix(shared);
  1718.  
  1719. 	//move the shared stuff to the front of the test
  1720. 	ret+=shared+"(";
  1721.  
  1722. 	//count the digits
  1723. 	var minDigits=min.length;
  1724. 	var maxDigits=max.length;
  1725.  
  1726. 	//set some flags
  1727. 	var isSingleDigit=(minDigits==1 && maxDigits==1);
  1728. 	var isVariableDigits=(minDigits != maxDigits);
  1729. 	
  1730. 	//using 1 to 4444 as a range
  1731. 	//calculate maximum range tests
  1732. 	//ie: 444x 44xx 4xxx
  1733. 	if (maxDigits>1){
  1734. 		ret+=max.substr(0,maxDigits-1)+"[0-"+max.substr(maxDigits-1,1)+"]";
  1735. 		for (var n=(maxDigits-2); n>0; n--) {
  1736. 			if (max.substr(n,1)!="0") {
  1737. 				ret+="|"+max.substr(0,n)+"[0-"+(val(max.substr(n,1))-1)+"]"+("\\d").repeat((maxDigits-1)-n);
  1738. 			}
  1739. 		}
  1740. 	}
  1741.  
  1742. 	//calculate intermediate range tests
  1743. 	//ie: 1xxx, 1xx, 1x
  1744. 	for (var n=maxDigits;n>1;n--){
  1745. 		//check if min and max both use this digit
  1746. 		if (minDigits==n && maxDigits==n) {
  1747. 			//as neither bound would be put out of range
  1748. 			//and the bounds are not equal
  1749. 			if ((min.substr(0,1)!="9") && (max.substr(0,1)!="1") && (val(max.substr(0,1))>(val(min.substr(0,1))+1))) {
  1750. 				ret+="|["+(val(min.substr(0,1))+1)+"-"+(val(max.substr(0,1))-1)+"]"+("\\d").repeat(n-1);
  1751. 			}
  1752. 		//detect if min uses this digit
  1753. 		} else if (minDigits==n) {
  1754. 			//as long as it does not start with 9
  1755. 			if (min.substr(0,1)!="9") {
  1756. 				ret+="|["+(val(min.substr(0,1))+1)+"-9]"+("\\d").repeat(n-1);
  1757. 			}
  1758. 			break;
  1759. 		//detect if max uses this digit
  1760. 		} else if (maxDigits==n) {
  1761. 			//as long as it does not start with 1
  1762. 			if (max.substr(0,1)!="1") {
  1763. 				ret+="|[1-"+(val(max.substr(0,1))-1)+"]"+("\\d").repeat(n-1);
  1764. 			}
  1765. 		} else {
  1766. 			//they do not use this digit
  1767. 			//is it BETWEEN their digit counts
  1768. 			if (n > minDigits) {
  1769. 				ret+="|[1-9]"+("\\d").repeat(n-1);
  1770. 			}
  1771. 		}
  1772. 	}
  1773. 			
  1774. 	//calculate minimum range tests
  1775. 	//ie: [1-9]
  1776. 	if (minDigits>1){
  1777. 		ret+="|"+min.substr(0,minDigits-1)+"["+min.substr(minDigits-1,1)+"-9]";
  1778. 		for (var n=(minDigits-2); n>0; n--) {
  1779. 			if (min.substr(n,1)!="9") {
  1780. 				ret+="|"+min.substr(0,n)+"["+(val(min.substr(n,1))+1)+"-9]"+("[0-9]").repeat((minDigits-1)-n);
  1781. 			}
  1782. 		}
  1783. 	} else {
  1784. 		//single digit min
  1785. 		if (maxDigits>minDigits) {
  1786. 			ret+="|["+min+"-9]";
  1787. 		} else {
  1788. 			//both min and max are single digits
  1789. 			ret+="|["+min+"-"+max+"]";
  1790. 		}
  1791. 	}
  1792. 	
  1793. 	//fix same start and end range issues
  1794. 	for (var i=0;i<=9;i++){
  1795. 		ret=ret.replace(new RegExp("\\["+i+"-"+i+"\\]","gi"),i);
  1796. 	}
  1797. 	ret=ret.replace(new RegExp("\\[0-9\\]","gi"),"\\d");
  1798. 	
  1799. 	return ret+")";
  1800. }catch(e){log("wmLibrary.integerRangeToRegExp: "+e);}};
  1801.  
  1802. //***************************************************************************************************************************************
  1803. //***** Typing Simulation
  1804. //***************************************************************************************************************************************
  1805.  
  1806. sandbox.simulateKeyEvent = function(character,byCode) {
  1807.   var evt = document.createEvent("KeyboardEvent");
  1808.   (evt.initKeyEvent || evt.initKeyboardEvent)("keypress", true, true, window,
  1809.                     0, 0, 0, 0,
  1810.                     0, ((byCode||null) || character.charCodeAt(0)) ) 
  1811.   var canceled = !body.dispatchEvent(evt);
  1812.   if(canceled) {
  1813.     // A handler called preventDefault
  1814.     alert("canceled");
  1815.   } else {
  1816.     // None of the handlers called preventDefault
  1817.     alert("not canceled");
  1818.   }
  1819. };
  1820.  
  1821. sandbox.typeText = function(s) {
  1822. 	for (var i=0,len=s.length; i<len; i++){
  1823. 		simulateKeyEvent(s.substr(i,1));
  1824. 		log(s.substr(i,1));
  1825. 	}
  1826. };
  1827.  
  1828. sandbox.typeEnter = function() {
  1829. 	simulateKeyEvent(null,13);
  1830. };
  1831.  
  1832. /*formatting notes
  1833. format a number to x decimal places
  1834. number.toFixed(x);
  1835.  
  1836. convert to hexidecimal
  1837. number.toString(16);
  1838.  
  1839. //try something like this to get your own header details
  1840. define your own parseHeaders function
  1841. var fileMETA = parseHeaders(<><![CDATA[
  1842. // ==UserScript==
  1843. // @name          My Script
  1844. // @namespace     http://www.example.com/gmscripts
  1845. // @description   Scripting is fun
  1846. // @copyright     2009+, John Doe (http://www.example.com/~jdoe)
  1847. // @license       GPL version 3 or any later version; http://www.gnu.org/copyleft/gpl.html
  1848. // @version       0.0.1
  1849. // @include       http://www.example.com/*
  1850. // @include       http://www.example.org/*
  1851. // @exclude       http://www.example.org/foo
  1852. // @require       foo.js
  1853. // @resource      resourceName1 resource1.png
  1854. // @resource      resourceName2 http://www.example.com/resource2.png
  1855. // @uso:script    scriptid
  1856. // ==/UserScript==
  1857. ]]></>.toString());
  1858.  
  1859. //include jquery stuff
  1860. // ==UserScript==
  1861. // @name          jQuery Example
  1862. // @require       http://ajax.googleapis.com/ajax/libs/jquery/1.3.2/jquery.min.js
  1863. // ==/UserScript==
  1864. */
  1865.  
  1866. //a custom collection wrapper
  1867. //this pretty much mimics collections in visual basic
  1868. //with a lot of collection methods added from other systems
  1869. var jsCollection=function(objOrArray){
  1870. 	var self=this;
  1871. 	this.items={};
  1872. 	
  1873. 	//return an item from this collection by index or key
  1874. 	this.__defineGetter__("item",function(indexOrKey){try{
  1875. 		return this.items[indexOrKey]||null;
  1876. 	}catch(e){log("jsCollection.item: "+e);}});
  1877.  
  1878. 	//return the count of items in this collection
  1879. 	this.__defineGetter__("count",function(){try{
  1880. 		var ret=0;
  1881. 		for (var e in this.items) ret++;
  1882. 		return ret;
  1883. 	}catch(e){log("jsCollection.count: "+e);}});
  1884. 	
  1885. 	//return true if the count of items in this collection is 0
  1886. 	this.__defineGetter__("isEmpty",function(){try{
  1887. 		return this.count==0;
  1888. 	}catch(e){log("jsCollection.isEmpty: "+e);}});
  1889.  
  1890. 	//remove all items from this collection
  1891. 	this.clear=function(){try{
  1892. 		while(this.items[0]) delete this.items[0];
  1893. 	}catch(e){log("jsCollection.clear: "+e);}};
  1894. 	
  1895. 	//return the index of the first occurence of obj
  1896. 	this.indexOf=function(obj){try{
  1897. 		var c=0;
  1898. 		for (var i in this.items){
  1899. 			if (this.items[i]===obj) {
  1900. 				return c;
  1901. 				break;
  1902. 			}
  1903. 			c++;
  1904. 		}
  1905. 		return -1;
  1906. 	}catch(e){log("jsCollection.indexOf: "+e);}};
  1907.  
  1908. 	//return the key of the first occurence of obj
  1909. 	this.keyOf=function(obj){try{
  1910. 		for (var i in this.items){
  1911. 			if (this.items[i]===obj) {
  1912. 				return i;
  1913. 				break;
  1914. 			}
  1915. 		}
  1916. 		return -1;
  1917. 	}catch(e){log("jsCollection.keyOf: "+e);}};
  1918.  
  1919. 	//returns true if obj occurs in this collection
  1920. 	this.contains=function(obj){try{
  1921. 		return this.indexOf(obj)!=-1;
  1922. 	}catch(e){log("jsCollection.contains: "+e);}};
  1923. 	
  1924. 	//returns true if an item in this collection has key = key
  1925. 	this.containsKey=function(key){try{
  1926. 		return exists(this.items[key]);
  1927. 	}catch(e){log("jsCollection.containsKey: "+e);}};
  1928.  
  1929. 	//remove an item from the collection by index or key
  1930. 	this.remove=function(indexOrKey){try{
  1931. 		delete this.items[indexOrKey];
  1932. 	}catch(e){log("jsCollection.remove: "+e);}};
  1933. 	
  1934. 	//add an item to the collection
  1935. 	//with optional key which defaults to unique()
  1936. 	//with optional before which is an object to match
  1937. 	//with optional after which is an object to match
  1938. 	this.add=function(item,key,before,after){try{
  1939. 		key=key||unique();
  1940. 		if (before && this.indexOf(before)!=-1) {
  1941. 			var ret={};
  1942. 			for (var i in this.items){
  1943. 				if (this.items[i]===before) {
  1944. 					ret[key]=item;
  1945. 				}
  1946. 				ret[i]=this.items[i];
  1947. 			}
  1948. 			this.items=ret;
  1949. 		} else if (after && this.indexOf(after)!=-1) {
  1950. 			var ret={};
  1951. 			for (var i in this.items){
  1952. 				ret[i]=this.items[i];
  1953. 				if (this.items[i]===after) {
  1954. 					ret[key]=item;	
  1955. 				}
  1956. 			}
  1957. 			this.items=ret;
  1958. 		} else {
  1959. 			this.items[key]=item;
  1960. 		}
  1961. 	}catch(e){log("jsCollection.add: "+e);}};
  1962. 	
  1963. 	//shortform to add an item
  1964. 	//after an item
  1965. 	//with optional key
  1966. 	this.insertAfter=function(item,after,key){try{
  1967. 		this.add(item,key,null,after);
  1968. 	}catch(e){log("jsCollection.insertAfter: "+e);}};		
  1969.  
  1970. 	//shortform to add an item
  1971. 	//before an item
  1972. 	//with optional key
  1973. 	this.insertBefore=function(item,before,key){try{
  1974. 		this.add(item,key,before,null);
  1975. 	}catch(e){log("jsCollection.insertBefore: "+e);}};		
  1976. 	
  1977. 	//shortform to add an item
  1978. 	//with optional key
  1979. 	this.append=function(item,key){try{
  1980. 		this.add(item,key);
  1981. 	}catch(e){log("jsCollection.append: "+e);}};			
  1982. 	
  1983. 	//shortform to add an item
  1984. 	//to the beginning of the collection
  1985. 	//with optional key
  1986. 	this.prepend=function(item,key){try{
  1987. 		this.add(item,key,(this.items[0]||null));
  1988. 	}catch(e){log("jsCollection.prepend: "+e);}};		
  1989.  
  1990. 	//add an array of items
  1991. 	//with optional before and after
  1992. 	this.addRange=function(itemArray,before,after){try{
  1993. 		if (before && this.indexOf(before)!=-1) {
  1994. 			var ret={};
  1995. 			for (var i in this.items){
  1996. 				if (this.items[i]===before) {
  1997. 					for (var a=0,len=itemArrayLength;a<len;a++){
  1998. 						ret[unique()]=itemArray[a];
  1999. 					}
  2000. 				}
  2001. 				ret[i]=this.items[i];
  2002. 			}
  2003. 			this.items=ret;
  2004. 		} else if (after && this.indexOf(after)!=-1) {
  2005. 			var ret={};
  2006. 			for (var i in this.items){
  2007. 				ret[i]=this.items[i];
  2008. 				if (this.items[i]===after) {
  2009. 					for (var a=0,len=itemArrayLength;a<len;a++){
  2010. 						ret[unique()]=itemArray[a];
  2011. 					}
  2012. 				}
  2013. 			}
  2014. 			this.items=ret;
  2015. 		} else {
  2016. 			for (var a=0,len=itemArrayLength;a<len;a++){
  2017. 				this.items[unique()]=itemArray[a];
  2018. 			}
  2019. 		}
  2020. 	}catch(e){log("jsCollection.addRange: "+e);}};		
  2021.  
  2022. 	//shortform to add an array of items
  2023. 	this.appendRange=function(itemArray){try{
  2024. 		this.addRange(itemArray);
  2025. 	}catch(e){log("jsCollection.appendRange: "+e);}};			
  2026. 	
  2027. 	//shortform to add an array of items
  2028. 	//to the beginning of the collection
  2029. 	this.prependRange=function(itemArray){try{
  2030. 		this.addRange(itemArray,(this.items[0]||null));
  2031. 	}catch(e){log("jsCollection.prependRange: "+e);}};	
  2032.  
  2033. 	//add a copy of item 
  2034. 	//with optional before or after
  2035. 	this.addCopy=function(item,before,after){try{
  2036. 		this.add(item,null,before,after);
  2037. 	}catch(e){log("jsCollection.addCopy: "+e);}};		
  2038.  
  2039. 	//add multiple copies of item
  2040. 	//with optional before and after
  2041. 	this.addCopies=function(item,count,before,after){try{
  2042. 		var ret=[];
  2043. 		for (var i=0;i<count;i++) ret.push(item);
  2044. 		this.addRange(item,before,after);
  2045. 	}catch(e){log("jsCollection.addCopies: "+e);}};		
  2046.  
  2047. 	//return the collection converted to an array
  2048. 	this.toArray=function(){try{
  2049. 		return methodsToArray(this.items);
  2050. 	}catch(e){log("jsCollection.toArray: "+e);}};
  2051.  
  2052. 	//return the index of item with key=key
  2053. 	this.indexOfKey=function(key){try{
  2054. 		return this.indexOf(this.items[key]||null);
  2055. 	}catch(e){log("jsCollection.indexOfKey: "+e);}};	
  2056. 	
  2057. 	//return the key of the item at index=index
  2058. 	this.keyOfIndex=function(index){try{
  2059. 		var c=0;
  2060. 		for (var i in this.items){
  2061. 			if (c==index) return i;
  2062. 			c++;
  2063. 		}
  2064. 	}catch(e){log("jsCollection.keyOfIndex: "+e);}};	
  2065.  
  2066. 	//use passed data on creation to create initial items
  2067. 	if (objOrArray){
  2068. 		if (isArrayAndNotEmpty(objOrArray)){
  2069. 			for (var i=0,len=objOrArray.length;i<len;i++){
  2070. 				this.add(objOrArray[i],i);
  2071. 			}
  2072. 		} else if (isObject(objOrArray)) {
  2073. 			for (var i in objOrArray){
  2074. 				this.items[i]=objOrArray[i];
  2075. 			}
  2076. 		}
  2077. 	}
  2078. 	
  2079. 	//return self for external use
  2080. 	return this;
  2081. };
  2082.  
  2083. })();