dolphindb 3.0.115 → 3.0.119

package/i18n/dict.json

@@ -97,5 +97,8 @@
     },
     "调用 ddb.invoke 的参数中不能同时有 DdbObj 与复杂 js 原生对象": {
         "en": "The parameters of calling ddb.invoke cannot contain both DdbObj and complex js native objects"
+    },
+    "iife 执行的脚本行数应该至少为 2 行": {
+        "en": "The number of script lines executed by iife should be at least 2"
     }
 }

package/index.d.ts

@@ -583,6 +583,7 @@ export interface DdbEvalOptions {
     urgent?: boolean;
     listener?: DdbMessageListener;
     parse_object?: boolean;
+    iife?: boolean;
 }
 export interface DdbExecuteOptions extends DdbEvalOptions, ConvertOptions {
 }
@@ -773,8 +774,9 @@ export declare class DDB {
                 不做解析，以便后续转发、序列化
                 Set parse_object during this rpc, and restore the original after the end.
                 When it is false, the returned DdbObj only contains buffer and le without parsing,
-                so as to facilitate subsequent forwarding and serialization */
-    eval<T extends DdbObj>(script: string, { urgent, listener, parse_object, }?: DdbEvalOptions): Promise<T>;
+                so as to facilitate subsequent forwarding and serialization
+            - iife?: 使用 `def () { ... } ()` 包裹脚本，return 最后一行，避免变量泄漏 */
+    eval<T extends DdbObj>(script: string, { urgent, listener, parse_object, iife, }?: DdbEvalOptions): Promise<T>;
     /** call function through websocket (function command)
         - func: 函数名  function name
         - args?: `[ ]` 调用参数 (传入的原生 string 和 boolean 会被自动转换为 DdbObj<string> 和 DdbObj<boolean>)

package/index.js

@@ -3082,8 +3082,19 @@ export class DDB {
                 不做解析，以便后续转发、序列化
                 Set parse_object during this rpc, and restore the original after the end.
                 When it is false, the returned DdbObj only contains buffer and le without parsing,
-                so as to facilitate subsequent forwarding and serialization */
-    async eval(script, { urgent, listener, parse_object, } = {}) {
+                so as to facilitate subsequent forwarding and serialization
+            - iife?: 使用 `def () { ... } ()` 包裹脚本，return 最后一行，避免变量泄漏 */
+    async eval(script, { urgent, listener, parse_object, iife, } = {}) {
+        if (iife) {
+            const lines = script.split_lines();
+            if (lines.length < 2)
+                throw new Error(t('iife 执行的脚本行数应该至少为 2 行'));
+            script =
+                'def () {\n' +
+                    lines.slice(0, -1).indent().join_lines() +
+                    `    return ${lines.last}\n` +
+                    '} ()\n';
+        }
         return this.rpc('script', { script, urgent, listener, parse_object });
     }
     /** call function through websocket (function command)