☰

WM Common Library

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

Script này sẽ không được không được cài đặt trực tiếp. Nó là một thư viện cho các script khác để bao gồm các chỉ thị meta // @require https://update.greatest.deepsurf.us/scripts/416/27761/WM%20Common%20Library.js 

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