☰

WM Common Library

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

此脚本不应直接安装，它是一个供其他脚本使用的外部库。如果您需要使用该库，请在脚本元属性加入：// @require https://update.gf.qytechs.cn/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. })();

欢迎访问Greasy Fork镜像

土豆服务器，请按需使用

镜像地址随时可能被墙，建议加群获取最新地址

加入Q群

QingJ © 2025

镜像随时可能失效，请加Q群300939539或关注我们的公众号极客氢云获取最新地址