JS 语言的动态性,使我们能够修改对象乃至类型的成员,主要有两种方式:

  1. proto/prototype 进行操作,修改原型对象;
  2. 使用代理 Proxy 对对象进行一次封装,返回包装后的代理对象给用户使用

一、通过修改原型对象

  1. /*增删改 Excel 对象的成员样例*/
  2. class ModifyRangeTypeExample {
  3. static AddMember() {
  4. let rng = new Range('B3');
  5. //1.通过 __proto__ 对象增加成员,是可行的;
  6. //2.添加方法时,不能建议使用箭头函数,因为在它内部
  7. // this is undefined,除非你增加的方法不需要访问
  8. // 实例本身
  9. ActiveCell.__proto__.AddressR1C1 = function(){
  10. return this.Address(false, false, xlR1C1);
  11. }
  12. Console.log(rng.AddressR1C1());
  13. Console.log(rng.Address(false, false, xlR1C1));
  14. //3.可以添加常字段形式的属性,每个实例访问到的此成
  15. // 员将是一样的值
  16. ActiveCell.__proto__.ABCDE = 12345;
  17. Console.log(rng.ABCDE);
  18. Console.log(ActiveCell.ABCDE);
  19. //4.也可以添加带有 getter/setter 的非字段形式的属性
  20. //4.1.通过 Object.create() 来实现 Data 属性
  21. ActiveCell.__proto__ = Object.create(
  22. ActiveCell.__proto__, {
  23. Data : {
  24. get() {
  25. return this.Value();
  26. },
  27. set(value) {
  28. this.Value2 = value;
  29. },
  30. configurable : true
  31. }
  32. });
  33. Console.log(rng.Data);
  34. rng.Data = 'Data Property';
  35. Console.log(rng.Data);
  36. //4.2.通过 Object.defineProperty() 来实现 Bold 属性
  37. Object.defineProperty(ActiveCell.__proto__,
  38. 'Bold', {
  39. get() {
  40. return this.Font.Bold;
  41. },
  42. set(value) {
  43. this.Font.Bold = value;
  44. },
  45. configurable : true
  46. });
  47. let isBold = rng.Font.Bold;
  48. Console.log('isBold?:' + isBold);
  49. rng.Bold = !isBold;
  50. Console.log('isBold?:' + rng.Bold);
  51. Console.log('isBold?:' + rng.Font.Bold);
  52. //4.3.通过 Object.defineProperties 来实现
  53. // Italic/Underline 属性
  54. Object.defineProperties(ActiveCell.__proto__,
  55. {
  56. Italic : {
  57. get() {
  58. return this.Font.Italic;
  59. },
  60. set(value) {
  61. this.Font.Italic = value;
  62. },
  63. configurable : true
  64. },
  65. Size : {
  66. get() {
  67. return this.Font.Size;
  68. },
  69. set(value) {
  70. this.Font.Size = value;
  71. },
  72. configurable : true
  73. }
  74. });
  75. //Italic Property Test
  76. let isItalic = rng.Font.Italic;
  77. Console.log('isItalic?:' + isItalic);
  78. rng.Italic = !isItalic;
  79. Console.log('isItalic?:' + rng.Italic);
  80. Console.log('isItalic?:' + rng.Font.Italic);
  81. //Size Property Test
  82. Console.log('font size?:' + rng.Font.Size);
  83. rng.Size = 9;
  84. Console.log('new font size?:' + rng.Size);
  85. Console.log('new font size?:' + rng.Font.Size);
  86. //5.通过属性描述符来定义属性
  87. /*描述符(https://segmentfault.com/a/1190000003882976):
  88. 有数据型描述符和存取型描述符。
  89. 两种类型的描述符都可以有 configurable 和 enumerable 描述符
  90. configurable : 它是 true 时,表明属性可以被覆写和删除,
  91. 默认值是 false.
  92. enumerable : 它是 true 时,属性可以被 for...in 枚举到;默认 false
  93. 数据型描述符,特有的是 value 和 writable 描述符:
  94. value : 提供属性值
  95. writable : 它是 true 时,属性值可变;默认值是 false
  96. 存取型描述符(上面 4.1-4.3 都是),特有的是 get 和 set 描述符
  97. get : 给属性提供 getter,返回值用作属性值;如果不提供它,则为 undefined
  98. set : 给属性提供 setter,用来修改属性值,有惟一参数;不提供为 undefined
  99. */
  100. Object.defineProperty(ActiveCell.__proto__,
  101. 'Smile', {
  102. value : '^_^',
  103. writable : false,
  104. enumerable : true,
  105. configurable : true
  106. });
  107. Console.log(rng.Smile);
  108. try {
  109. //这句会报错
  110. rng.Smile = '-_-';
  111. } catch { }
  112. Console.log(rng.Smile);
  113. }
  114. static ReplaceMember() {
  115. //1.JS 是基于原型链的,你可以通过 __proto__ 或者
  116. // prototype 访问原型,它也是个对象
  117. //2.你可以为原型对象,添加成员来为属于它的所有实例
  118. // 添加更多属性与操作(方法)
  119. //3.对象被构造时固有的成员,你可以通过
  120. // Object.getOwnPropertyNames() 方法来取得,且它
  121. // 不包含通过 __proto__ 或 prototype 定义在原型上
  122. // 的成员
  123. //4.因为实例的固有成员的优先级,要高于附加在
  124. // __proto__ 或 prototype 上的同名成员,所以虽然你可
  125. // 以为原型对象加上同名的成员,但实例对象是无法直接访
  126. // 问到它们的,所以想覆写固有成员,是做不到的
  127. //4.1.在 __proto__ 上创建同名方法,以图覆写它:
  128. ActiveCell.__proto__.Delete = function() {
  129. Console.log('Deleting range ' + this.Address());
  130. }
  131. let rng = new Range('B2:C3');
  132. for (let i = 1; i <= rng.Cells.Count; i++)
  133. rng.Cells.Item(i).Value2 =
  134. rng.Cells.Item(i).Address();
  135. let sht = rng.Worksheet;
  136. //由以下两个输出,你会了解到实例直接访问到
  137. //的还是被构造时固有的 Delete() 方法
  138. Console.log(sht.Range('B2').Value2);
  139. rng.Cells.Item(1).Delete();
  140. Console.log(sht.Range('B2').Value2);
  141. //但是你仍可以通过如下方式,访问到同名方法
  142. rng.__proto__.Delete.call(rng);
  143. //4.2.在 __proto__ 上创建同名属性,以图覆写它:
  144. Object.defineProperty(ActiveCell.__proto__, 'Text', {
  145. get() {
  146. return this.Address() + " : " + this.Value2.toString();
  147. },
  148. set(value) {
  149. this.Value2 = value;
  150. },
  151. configurable : true,
  152. enumerale : true
  153. });
  154. let cell = sht.Range('B2');
  155. Console.log(cell.Text);
  156. try {
  157. //这句会报错,因为固有的 Text 属性是只读的
  158. cell.Text = 321;
  159. } catch { }
  160. Console.log(cell.Text);
  161. //你总可以通过属性的描述符对象拿到 getter/setter,如果提供了
  162. let desc = Object.getOwnPropertyDescriptor(
  163. ActiveCell.__proto__, 'Text');
  164. let setter = desc.set;
  165. setter.call(cell/*第一个参数绑定 this*/, 111/*设定新值*/);
  166. let getter = desc.get;
  167. Console.log(getter.call(cell/*第一个参数绑定 this*/));
  168. }
  169. static DeleteMember() {
  170. //1.删除原型对象上一个不存在的成员
  171. let result = 'AreYouOkey' in ActiveCell.__proto__ &&
  172. delete ActiveCell.__proto__.AreYouOkey;
  173. Console.log('删除 AreYouOkey 成功?:' + result);
  174. //2.删除原型上已经存在的成员
  175. ActiveCell.__proto__.YesItIs = 857;
  176. result = 'YesItIs' in ActiveCell.__proto__ &&
  177. delete ActiveCell.__proto__;
  178. Console.log('删除 YesItIs 成功?:' + result);
  179. let rng = new Range('B2');
  180. //3.删除对象上已经存在的属性
  181. try {
  182. //会失败,因为 configurable = false
  183. result = 'Text' in rng &&
  184. delete rng.Text;
  185. } catch { result = false; }
  186. Console.log('删除 Text 成功?:' + result);
  187. //4.删除对象上已经存在的方法
  188. try {
  189. //会失败,因为 configurable = false
  190. result = 'Address' in rng &&
  191. delete rng.Address;
  192. } catch { result = false; }
  193. Console.log('删除 Address() 成功?:' + result);
  194. //5.对于对象固有属性,可以通过
  195. // Object.getOwnPropertyDescriptor(obj, pptName) 方法
  196. // 来查看成员的描述符,由 configurable 描述符来确定它是
  197. // 否支持 delete 操作
  198. //5.1.固有属性的描述符
  199. let textDesc = Object.getOwnPropertyDescriptor(rng, 'Text');
  200. Console.log(JSON.stringify(textDesc, undefined, 4));
  201. //5.2.固有方法的描述符
  202. let addressDesc = Object.getOwnPropertyDescriptor(rng, 'Address');
  203. Console.log(JSON.stringify(addressDesc, undefined, 4));
  204. }
  205. static RunAll() {
  206. let padCenter = (str) => {
  207. let restWidth = 56 - str.length;
  208. let left = Math.floor(restWidth / 2);
  209. let right = left + restWidth % 2;
  210. return '-'.repeat(left) + str + '-'.repeat(right);
  211. }
  212. Console.log(padCenter(ModifyRangeTypeExample.AddMember.name));
  213. ModifyRangeTypeExample.AddMember();
  214. Console.log(padCenter(ModifyRangeTypeExample.ReplaceMember.name));
  215. ModifyRangeTypeExample.ReplaceMember();
  216. Console.log(padCenter(ModifyRangeTypeExample.DeleteMember.name));
  217. ModifyRangeTypeExample.DeleteMember();
  218. ModifyRangeTypeExample.Clear();
  219. }
  220. //清除 RunAll() 调用后,创建的成员
  221. static Clear() {
  222. for (let name in ActiveCell.__proto__)
  223. delete ActiveCell.__proto__[name];
  224. }
  225. }

在【立即窗口】里面输入 ModifyRangeTypeExample.RunAll(); 然后回车,即可执行以上测试,其输出如下:

  1. -----------------------AddMember------------------------
  2. R[2]C[1]
  3. R[2]C[1]
  4. 12345
  5. 12345
  6. Data Property
  7. isBold?:false
  8. isBold?:true
  9. isBold?:true
  10. isItalic?:false
  11. isItalic?:true
  12. isItalic?:true
  13. font size?:11
  14. new font size?:9
  15. new font size?:9
  16. ^_^
  17. ^_^
  18. ---------------------ReplaceMember----------------------
  19. $B$2
  20. $B$3
  21. Deleting range $B$2:$C$3
  22. $B$3
  23. $B$3
  24. $B$2 : 111
  25. ----------------------DeleteMember----------------------
  26. 删除 AreYouOkey 成功?:false
  27. 删除 YesItIs 成功?:true
  28. 删除 Text 成功?:false
  29. 删除 Address() 成功?:false
  30. {
  31. "value": "111",
  32. "writable": false,
  33. "enumerable": true,
  34. "configurable": false
  35. }
  36. {
  37. "writable": false,
  38. "enumerable": true,
  39. "configurable": false
  40. }

综上:

  1. 我们总可以通过对象的 proto 访问到对象的原型,并在此原型对象上增添一些成员,这总是没问题的
  2. 因为对象被构造产生的成员的访问优先级,高于原型对象上增添的同名成员,所以实际上并不能覆写已有的成员
  3. 因为内置对象的成员大多数是 configurable == false,即不可改变与删除,所以删除成员就别想了

二、通过代理的方式

  1. //居中填充
  2. String.prototype.padCenter =
  3. function(targetLength, padString = ' ') {
  4. if (typeof targetLength != 'number')
  5. throw new TypeError('Parameter "targetLength" ' +
  6. 'must be a number object.');
  7. if (typeof padString != 'string') {
  8. if (padString === null)
  9. padString = 'null';
  10. else
  11. padString = padString.toString();
  12. }
  13. let padStrWidth = padString.length;
  14. if (padStrWidth == 0) return this;
  15. let restWidth = targetLength - this.length;
  16. if (restWidth <= 0) return this;
  17. let leftWidth = Math.trunc(restWidth / 2);
  18. let rightWidth = leftWidth + restWidth % 2;
  19. if (padString.length == 1) {
  20. return padString.repeat(leftWidth) + this +
  21. padString.repeat(rightWidth);
  22. } else {
  23. if (leftWidth == 0)
  24. return this + padString[0];
  25. else {
  26. //leftPart
  27. let leftRepeat = Math.trunc(leftWidth / padStrWidth);
  28. let leftRest = leftWidth - leftRepeat * padStrWidth;
  29. let leftStr = padString.repeat(leftRepeat) +
  30. padString.substr(0, leftRest);
  31. //rightPart
  32. let rightRepeat = Math.trunc(rightWidth / padStrWidth);
  33. let rightRest = rightWidth - rightRepeat * padStrWidth;
  34. let rightStr = padString.repeat(rightRepeat) +
  35. padString.substr(0, rightRest);
  36. return leftStr + this + rightStr;
  37. }
  38. }
  39. }
  40. /*Proxy handler 可对应于
  41. Reflect.apply()
  42. Reflect.construct()
  43. Reflect.defineProperty()
  44. Reflect.deleteProperty()
  45. Reflect.get()
  46. Reflect.getOwnPropertyDescriptor()
  47. Reflect.getPrototypeOf()
  48. Reflect.has()
  49. Reflect.isExtensible()
  50. Reflect.ownKeys()
  51. Reflect.preventExtensions()
  52. Reflect.set()
  53. Reflect.setPrototypeOf()
  54. 实现想要的代理
  55. */
  56. class ES6ProxyTest {
  57. //既然 Reflect.set(target, key, value[, receiver]) 有
  58. //要设置的属性的键和值,我们就可以通过 set 代理,在一个
  59. //对象的定义的外部:
  60. //1.通过键,拦截对某些属性的写入
  61. //2.通过值,检验类型,拦截非法写入
  62. //3.通过键,重定向属性的写入,就像为属性设置一些假名一样
  63. static SetProxy() {
  64. let p = new Point(3, 8);
  65. let pp = new Proxy(p, {
  66. set:function(target, key, value, receiver){
  67. //Reflect.set(target, key, value[, receiver])
  68. //target : 用于接收属性(被代理的对象)的对象
  69. //key : 要写入的属性的键(字符串或Symbol类型)
  70. //value : 要写入的属性新值
  71. //receiver : 如果 target 对象的 key 属性有 setter,
  72. // receiver 则为 setter 调用时的 this 值。
  73. //return : 返回一个 Boolean 值,表明操作的成败
  74. let success = Reflect.set(target, key, value, receiver);
  75. if (success) {
  76. //Console 在此不可用
  77. Debug.Print('property '+ key +' on '+
  78. target + ' set to '+ value);
  79. }
  80. //必须返回操作成败状态,否则报错
  81. return success;
  82. }
  83. });
  84. pp.xxx = 13;
  85. Console.log(p.xxx);
  86. }
  87. //既然 Reflect.get(target, key[, receiver]) 提供了要读取
  88. //的属性的键,我们就可以通过 get 代理,在对象的定义的外部:
  89. //1.通过键,拦截对某些属性的读取
  90. //2.通过键,伪造一些不存在的属性
  91. //3.通过键,实现类同假名的属性
  92. static GetProxy() {
  93. var obj = new Proxy({}, {
  94. get: function (target, key, receiver) {
  95. //Console 在此不可用
  96. Debug.Print(`getting ${key}!`);
  97. //Reflect.get(target, key[, receiver])
  98. //target : 被代理的对象
  99. //key : 要读取的属性的键(字符串或Symbol类型)
  100. //receiver : 如果 target 对象的 key 属性有 getter,
  101. // receiver 则为 getter 调用时的 this 值。
  102. //return : 属性的值。
  103. return Reflect.get(target, key, receiver);
  104. }
  105. });
  106. obj.count = 1;
  107. ++obj.count;
  108. }
  109. /*Reflect.apply(target, thisArg, argsList)
  110. target : 被代理对象,请确保它是一个 Function 对象
  111. thisArg : 函数调用时绑定的对象
  112. argsList : 函数调用时传入的实参列表,该参数应该是一个类数组的对象。
  113. return : 调用函数返回的结果
  114. 通过这种代理:
  115. 1.检验调用时传入的参数
  116. 2.阻止函数被调用
  117. */
  118. static ApplyProxy() {
  119. function sum (...values){
  120. return values.reduce((pre, cur) => pre + cur, 0);
  121. }
  122. let sumProxy = new Proxy(sum, {
  123. apply : function(target, thisArg, argsList){
  124. argsList.forEach(arg => {
  125. if(typeof arg !== "number")
  126. throw new TypeError("所有参数必须是数字,亲!");
  127. });
  128. return Reflect.apply(target, thisArg, argsList);
  129. }
  130. });
  131. try {
  132. let r = sumProxy(3, 5, 'hello');
  133. Console.log(r);
  134. } catch(e) {
  135. Console.log(e.message);
  136. }
  137. Console.log(sumProxy(3, 8, 5));
  138. }
  139. /*Reflect.construct(target, argsList[, newTarget])
  140. target : 被运行的目标构造函数
  141. argsList : 类数组,目标构造函数调用时的参数。
  142. newTarget : 可选,作为新创建对象的原型对象的 constructor 属性,
  143. 参考 new.target 操作符,默认值为 target。
  144. */
  145. static ConstructProxy() {
  146. function sum (...values){
  147. return values.reduce((pre, cur) => pre + cur, 0);
  148. }
  149. let sumProxy = new Proxy(sum, {
  150. construct:function(target, argsList){
  151. throw new TypeError("亲,该函数不能通过 new 调用。");
  152. }
  153. });
  154. try {
  155. let x = new sumProxy(3, 5, 7);
  156. } catch(e) {
  157. Console.log(e.message);
  158. }
  159. }
  160. //禁止向指定单元格区域写入数据
  161. static ForbidSetValue() {
  162. let rng = new Range('B1:D3');
  163. rng.Value2 = 32;
  164. let rngProxy = new Proxy(rng, {
  165. set : function(target, key, value, receiver) {
  166. if (key === 'Value2') {
  167. throw new Error('无法设置属性')
  168. } else
  169. return Reflect.set(target, key, value, receiver);
  170. }
  171. });
  172. try {
  173. rngProxy.Value2 = 168;
  174. } catch(e) {
  175. Console.log(e.message);
  176. }
  177. Console.log(rngProxy.Text);
  178. }
  179. //运行所有测试用例
  180. static RunAll() {
  181. let members = Object.getOwnPropertyNames(ES6ProxyTest);
  182. let notCall = ['length', 'prototype', 'name', 'RunAll'];
  183. for (let member of members) {
  184. if (!notCall.includes(member)) {
  185. Console.log(member.padCenter(56, '-'));
  186. eval(`ES6ProxyTest.${member}()`);
  187. }
  188. }
  189. }
  190. }

三、修改原型来汉化对象模型

  1. /*借助原型对象汉化对象成员样例*/
  2. class ChinesizationRangeTypeExample {
  3. static Do() {
  4. ActiveCell.__proto__.取地址 = function() {
  5. return this.Address(...arguments);
  6. };
  7. Object.defineProperty(ActiveCell.__proto__, '值', {
  8. get() { return this.Value2; },
  9. set(value) { this.Value2 = value; },
  10. configurable : true,
  11. enumerable : true
  12. });
  13. ActiveCell.__proto__.取值 = function() {
  14. return this.Value();
  15. }
  16. }
  17. static Undo() {
  18. for (let name in ActiveCell.__proto__)
  19. delete ActiveCell.__proto__[name];
  20. }
  21. static CallGetterSetterOtherWay() {
  22. let rng = new Range('A1:B3, C5:E4');
  23. rng.值 = 159;
  24. let cell = rng.Cells.Item(1);
  25. Console.log(cell.值);
  26. let desc = Object.getOwnPropertyDescriptor(
  27. ActiveCell.__proto__, '值');
  28. let setter = desc.set;
  29. setter.call(cell/*第一个参数绑定 this*/, 357/*设置新值*/);
  30. Console.log(cell.值);
  31. //也可以通过 getter 来读取值
  32. let getter = desc.get;
  33. Console.log(getter.call(cell/*绑定this*/));
  34. }
  35. static CallMethodOtherWay() {
  36. let cell = new Range('A1');
  37. let address = ActiveCell.__proto__.取地址
  38. .call(cell/*第一个参数绑定 this*/);
  39. Console.log(address);
  40. }
  41. static WorkonIt() {
  42. let rng = new Range('B2');
  43. Console.log(rng.取地址());
  44. Console.log(rng.取地址(true, true, xlR1C1));
  45. rng.值 = 32;
  46. Console.log(rng.值);
  47. Console.log(rng.取值());
  48. }
  49. static RunAll() {
  50. //执行汉化
  51. ChinesizationRangeTypeExample.Do();
  52. //测试汉化
  53. ChinesizationRangeTypeExample.WorkonIt();
  54. //别样调用属性
  55. ChinesizationRangeTypeExample.CallGetterSetterOtherWay();
  56. //别样调用方法
  57. ChinesizationRangeTypeExample.CallMethodOtherWay();
  58. //撤销汉化
  59. ChinesizationRangeTypeExample.Undo();
  60. }
  61. }

其输出如下:

  1. $B$2
  2. R2C2
  3. 32
  4. 32
  5. 357
  6. $A$1