☰

Hooks

A JavaScript hook/reply ultility

当前为 2018-06-06 提交的版本，查看 最新版本。

此脚本不应直接安装。它是供其他脚本使用的外部库，要使用该库请加入元指令 // @require https://update.gf.qytechs.cn/scripts/18715/603566/Hooks.js 

  1. // ==UserScript==
  2. // @name			Hooks
  3. // @namespace		xuyiming.open@outlook.com
  4. // @description		A JavaScript hook/reply ultility
  5. // @author			xymopen
  6. // @version			1.1.3
  7. // @grant			none
  8. // @license			BSD 2-Clause
  9. // @homepageURL		https://github.com/xymopen/JS_Misc/blob/master/Hooks.js
  10. // @updateURL		https://raw.githubusercontent.com/xymopen/JS_Misc/master/Hooks.js
  11. // ==/UserScript==
  12.  
  13. // TODO: JsDoc
  14. // TODO: Unit test
  15.  
  16. var Hooks = ( function() {
  17. 	"use strict";
  18. 	
  19. 	/**
  20. 	 * Hooks functions or properties, getters/setters
  21. 	 * and methods of an object you are intrested in
  22. 	 */
  23. 	var Hooks = {
  24. 		/**
  25. 		 * hook a function
  26. 		 * @function apply
  27. 		 * @param {function} target				- a function to be hook
  28. 		 * @param {onApply} onApply				- the hook
  29. 		 */
  30. 		"apply": function apply( target, onApply ) {
  31. 			if ( "function" === typeof target && "function" === typeof onApply ) {
  32. 				return function() {
  33. 					return onApply.call( this, target, this, arguments );
  34. 				};
  35. 			} else {
  36. 				throw new TypeError();
  37. 			}
  38. 		},
  39. 		/**
  40. 		 * @callback onApply the hook
  41. 		 * @param {function} target				- the function hooked
  42. 		 * @param {object|undefined} thisArg	- #this reference
  43. 		 * @param {arguments} argv				- the arguments pass to the target
  44. 		 */
  45.  
  46. 		/**
  47. 		 * hook a property of an object
  48. 		 * @function property
  49. 		 * @param {object} target				- an object having or to have the property to be hooked
  50. 		 * @param {string} propertyName			- the name of the property to be hooked
  51. 		 * @param {onGet} onGet					- the hook call when about to get the property
  52. 		 * @param {onSet} onSet					- the hook call when about to set the property
  53. 		 */
  54. 		"property": function property( target, propertyName, onGet, onSet ) {
  55. 			var descriptor, oldValue;
  56.  
  57. 			if ( Object.prototype.hasOwnProperty.call( target, propertyName ) ) {
  58. 				descriptor = Object.getOwnPropertyDescriptor( target, propertyName );
  59.  
  60. 				if ( Object.prototype.hasOwnProperty.call( descriptor, "value" ) ) {
  61. 					oldValue = descriptor.value;
  62.  
  63. 					delete descriptor.value;
  64. 					delete descriptor.writable;
  65. 				} else if ( Object.prototype.hasOwnProperty.call( descriptor, "get" ) ) {
  66. 					oldValue = descriptor.get.call( target );
  67. 				} else {
  68. 					oldValue = undefined;
  69. 				}
  70. 			} else {
  71. 				descriptor = {
  72. 					"configurable": true,
  73. 					"enumerable": true,
  74. 				};
  75. 				
  76. 				oldValue = undefined;
  77. 			}
  78.  
  79. 			descriptor.get = function get() {
  80. 				return onGet.call( this, target, propertyName, oldValue );
  81. 			};
  82.  
  83. 			descriptor.set = function set( newValue ) {
  84. 				oldValue = onSet.call( this, target, propertyName, oldValue, newValue );
  85. 				return oldValue;
  86. 			};
  87.  
  88. 			Object.defineProperty( target, propertyName, descriptor );
  89. 		},
  90. 		/**
  91. 		 * the hook call when about to get the property
  92. 		 * @callback onGet
  93. 		 * @param {object} target				- the object having the property hooked
  94. 		 * @param {string} propertyName			- the name of the property hooked
  95. 		 * @param {any} oldValue				- the current value of the property
  96. 		 */
  97.  
  98. 		/**
  99. 		 * the hook call when about to set the property
  100. 		 * @callback onSet
  101. 		 * @param {object} target				- the object having the property hooked
  102. 		 * @param {string} propertyName			- the name of the property hooked
  103. 		 * @param {any} oldValue				- the current value of the property
  104. 		 * @param {any} newValue				- the value about to be set to the property
  105. 		 */
  106.  
  107. 		/**
  108. 		 * alias of #property but fill the #onSet automatically
  109. 		 * @function get
  110. 		 * @param {object} target				- an object having or to have the property to be hooked
  111. 		 * @param {string} propertyName			- he name of the property to be hooked
  112. 		 * @param {onGet} onGet					- the hook call when about to get the property
  113. 		 */
  114. 		"get": function get( target, propertyName, onGet ) {
  115. 			return Hooks.property( target, propertyName, onGet, function( target, propertyName, oldValue, newValue ) {
  116. 				return Hooks.Reply.get( arguments );
  117. 			} );
  118. 		},
  119. 		/**
  120. 		 * the hook call when about to get the property
  121. 		 * @callback onGet
  122. 		 * @param {object} target				- the object having the property hooked
  123. 		 * @param {string} propertyName			- the name of the property hooked
  124. 		 * @param {any} oldValue				- the current value of the property
  125. 		 */
  126.  
  127. 		/**
  128. 		 * alias of #property but fill the #onGet automatically
  129. 		 * @function set
  130. 		 * @param {object} target				- an object having or to have the property to be hooked
  131. 		 * @param {string} propertyName			- the name of the property to be hooked
  132. 		 * @param {onSet} onSet					- the hook call when about to set the property
  133. 		 */
  134. 		"set": function set( target, propertyName, onSet ) {
  135. 			return Hooks.property( target, propertyName, function( target, propertyName, oldValue ) {
  136. 				return Hooks.Reply.set( arguments );
  137. 			}, onSet );
  138. 		},
  139. 		/**
  140. 		 * the hook call when about to set the property
  141. 		 * @callback onSet
  142. 		 * @param {object} target				- the object having the property hooked
  143. 		 * @param {string} propertyName			- he name of the property hooked
  144. 		 * @param {any} oldValue				- the current value of the property
  145. 		 * @param {any} newValue				- the value about to be set to the property
  146. 		 */
  147.  
  148. 		/**
  149. 		 * hook a method of an object
  150. 		 * @function method
  151. 		 * @param {object} target				- an object having or to have the method to be hooked
  152. 		 * @param {string} methodName			- the name of the method to be hooked
  153. 		 * @param {onApply} onApply				- the hook replace the method
  154. 		 */
  155. 		"method": function method( target, methodName, onApply ) {
  156. 			var method = target[ methodName ], descriptor;
  157. 			
  158. 			function hookMethod( method, onApply ) {
  159. 				return Hooks.apply( method, function( method, thisArg, argv ) {
  160. 					return onApply.call( this, target, methodName, method, thisArg, argv );
  161. 				} );
  162. 			};
  163. 			
  164. 			if ( "function" === typeof method ) {
  165. 				target[ methodName ] = hookMethod( method, onApply );
  166. 			} else {
  167. 				if ( Object.prototype.hasOwnProperty.call( target, propertyName ) ) {
  168. 					throw new Error( "ERR_PROPERTY_EXISTS_NOT_METHOD" );
  169. 				} else {
  170. 					Hooks.set( target, methodName, function onSet( target, propertyName, oldValue, newValue ) {
  171. 						Object.defineProperty( target, methodName, {
  172. 							"configurable": true,
  173. 							"enumerable": true,
  174. 							"value": "function" === typeof newValue ? hookMethod( newValue, onApply ) : newValue,
  175. 							"writable": true,
  176. 						} );
  177. 					} );
  178. 				}
  179. 			}
  180. 		},
  181. 		/**
  182. 		 * the hook replace the method
  183. 		 * @callback onApply
  184. 		 * @param {object} target				- the object having the method hooked
  185. 		 * @param {string} methodName			- the name of the method hooked
  186. 		 * @param {object|undefined} thisArg	- #this reference
  187. 		 * @param {arguments} argv				- the arguments pass to the method
  188. 		 */
  189. 		
  190. 		/**
  191. 		 * hook a getter property of an object
  192. 		 * @function getter
  193. 		 * @param {object} target				- an object having the getter property to be hooked
  194. 		 * @param {string} propertyName			- the name of the getter property to be hooked
  195. 		 * @param {onGetter} onGetter				- the hook replace the getter
  196. 		 */
  197. 		"getter": function getter( target, propertyName, onGetter ) {
  198. 			return trap( target, propertyName, onGetter, "get", "ERR_NOT_A_GETTER" );
  199. 		},
  200. 		/**
  201. 		 * the hook replace the getter
  202. 		 * @callback onSetter
  203. 		 * @param {object} target				- the object having the getter property hooked
  204. 		 * @param {string} propertyName			- he name of the getter property hooked
  205. 		 * @param {function} getter				- the getter replaced
  206. 		 * @param {object|undefined} thisArg	- #this reference
  207. 		 * @param {arguments} argv				- the arguments pass to the getter, should be #undefined
  208. 		 */
  209.  
  210. 		/**
  211. 		 * hook a setter property of an object
  212. 		 * @function setter
  213. 		 * @param {object} target				- an object having the setter property to be hooked
  214. 		 * @param {string} propertyName			- the name of the setter property to be hooked
  215. 		 * @param {onSetter} onSetter				- the hook replace the setter
  216. 		 */
  217. 		"setter": function setter( target, propertyName, onSetter ) {
  218. 			return trap( target, propertyName, onSetter, "set", "ERR_NOT_A_SETTER" );
  219. 		},
  220. 		/**
  221. 		 * the hook replace the setter
  222. 		 * @callback onSetter
  223. 		 * @param {object} target				- the object having the setter property hooked
  224. 		 * @param {string} propertyName			- he name of the setter property hooked
  225. 		 * @param {function} setter				- the setter replaced
  226. 		 * @param {object|undefined} thisArg	- #this reference
  227. 		 * @param {arguments} argv				- the arguments pass to the setter, should be a right value
  228. 		 */
  229. 	};
  230. 	
  231. 	var Reply = {
  232. 		"apply": function apply( param ) {
  233. 			var target = param[ 0 ],
  234. 				thisArg = param[ 1 ],
  235. 				argv = param[ 2 ];
  236. 			
  237. 			return target.apply( thisArg, argv );
  238. 		},
  239. 		
  240. 		"get": function( param ) {
  241. 			var target = param[ 0 ],
  242. 				propertyName = param[ 1 ],
  243. 				oldValue = param[ 2 ],
  244. 				newValue = param[ 3 ];
  245. 			
  246. 			return param[ param.length - 1 ];
  247. 		},
  248. 		
  249. 		"getter": function( param ) {
  250. 			var target = param[ 0 ],
  251. 				propertyName = param[ 1 ],
  252. 				fn = param[ 2 ],
  253. 				thisArg = param[ 3 ],
  254. 				argv = param[ 4 ];
  255. 			
  256. 			return fn.apply( thisArg, argv );
  257. 		},
  258. 		
  259. 		"method": function method( param ) {
  260. 			var target = param[ 0 ],
  261. 				methodName = param[ 1 ],
  262. 				method = param[ 2 ],
  263. 				thisArg = param[ 3 ],
  264. 				argv = param[ 4 ];
  265. 			
  266. 			return method.apply( thisArg, argv );
  267. 		},
  268. 	};
  269. 	
  270. 	Reply.set = Reply.get;
  271. 	Reply.setter = Reply.getter;
  272. 	
  273. 	Hooks.Reply = Reply;
  274.  
  275. 	return Hooks;
  276. } )();

欢迎访问Greasy Fork镜像

土豆服务器，请按需使用

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

加入Q群

QingJ © 2025

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