V3.2.5 Update - RC3

Author: SheepChef

docs/document/js-deploy.md

@@ -60,9 +60,10 @@ let Abra = new Abracadabra(); //不附带参数，
  * @param {string} mode 指定模式，可以是 ENCRYPT DECRYPT 中的一种;
  * @param {string} key 指定密钥，默认是 ABRACADABRA;
  * @param {WenyanConfig} WenyanConfigObj 文言文的生成配置;
+ * @param {any}callback 回调函数，获取执行过程中特定位置的结果
  * @return {number} 成功则返回 0（失败不会返回，会抛出异常）
  */
-Abra.WenyanInput(input, mode, key, {...});
+Abra.WenyanInput(input, mode, key, {...}, callback);
 ```
 
 第一个参数 `input` 接受两种类型的输入，分别是 `String` 和 `Uint8Array`，这是此前在实例化的时候指定的输入类型。
@@ -75,6 +76,8 @@ Abra.WenyanInput(input, mode, key, {...});
 
 如果指定了错误的密码，那么在解码/解密数据校验过程中会抛出错误。
 
+第五个参数接受一个 callback 函数，程序会在执行中关键位置多次调用此函数，以便调试，无特殊用途可忽略此项。
+
 第四个参数接受一个`WenyanConfig`配置对象的输入，仅在加密的时候需要：
 
 ```javascript

src/javascript/ChineseMappingHelper.js

@@ -662,10 +662,6 @@ export class WenyanSimulator {
 
     this.RoundKey(); //首次对表前，先转动一次转轮
     for (let j = 0; j < Sentence.length; j++) {
-      try {
-        if (this.callback != null)
-          this.callback(new CallbackObj("ENC_MAPTEMP", TempStr1));
-      } catch (err) {}
       hasSpecialEndSymbol = false;
       CommaNumInSentence = 0;
       for (let k = 0; k < Sentence[j].length; k++) {
@@ -758,6 +754,10 @@ export class WenyanSimulator {
           //如果已填充的有效载荷满足了预计添加的载荷，那么标记已完成。
           Finished = true;
         }
+        try {
+          if (this.callback != null)
+            this.callback(new CallbackObj("ENC_MAPTEMP", TempStr1));
+        } catch (err) {}
       }
       //这里是句式和句式的外层控制循环
       if (Finished) {
@@ -772,6 +772,11 @@ export class WenyanSimulator {
           LastQuoteMark = false;
         }
         NoAutoSymbol = false;
+        try {
+          if (this.callback != null)
+            this.callback(new CallbackObj("ENC_MAPTEMP", TempStr1));
+        } catch (err) {}
+
         break;
       } else {
         if (q && !hasSpecialEndSymbol && !NoAutoSymbol) {

src/javascript/RoundObfusHelper.js

@@ -12,6 +12,7 @@
 
 import CryptoJS from "crypto-js";
 import { wordArrayToUint8Array } from "./Misc.js";
+import { CallbackObj } from "./CoreHandler.js";
 
 export class RoundObfus {
   constructor(key, callback = null) {

src/javascript/main.d.ts

@@ -34,13 +34,15 @@ export class Abracadabra {
    * @param {string} mode 指定模式，可以是 ENCRYPT DECRYPT 中的一种;
    * @param {string} key 指定密钥，默认是 ABRACADABRA;
    * @param {WenyanConfig} WenyanConfigObj 文言文的生成配置;
+   * @param {any}callback 回调函数，获取执行过程中特定位置的结果
    * @return {number} 成功则返回 0（失败不会返回，会抛出异常）
    */
   WenyanInput(
     input: string | Uint8Array,
     mode: "ENCRYPT" | "DECRYPT",
     key?: string,
-    WenyanConfigObj?: WenyanConfig
+    WenyanConfigObj?: WenyanConfig,
+    callback?: any
   ): number;
 
   /**

src/javascript/main.js

@@ -89,7 +89,7 @@ export class Abracadabra {
       } else if (mode == Abracadabra.DECRYPT) {
         let Nextinput = new Object();
         Nextinput.output = input;
-        this.#res = Core.Dec(Nextinput, key);
+        this.#res = Core.Dec(Nextinput, key, callback);
       }
       return 0;
     } else if (this.#input == Abracadabra.TEXT) {
@@ -102,7 +102,7 @@ export class Abracadabra {
       if (mode == Abracadabra.ENCRYPT) {
         this.#res = Core.Enc(Nextinput, key, WenyanConfigObj, callback);
       } else if (mode == Abracadabra.DECRYPT) {
-        this.#res = Core.Dec(Nextinput, key);
+        this.#res = Core.Dec(Nextinput, key, callback);
       }
       return 0;
     }