dolphindb 3.0.115 → 3.0.118

package/browser.d.ts

@@ -594,6 +594,7 @@ export interface DdbEvalOptions {
     urgent?: boolean;
     listener?: DdbMessageListener;
     parse_object?: boolean;
+    iife?: boolean;
 }
 export interface DdbExecuteOptions extends DdbEvalOptions, ConvertOptions {
 }
@@ -783,8 +784,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/browser.js

@@ -3104,8 +3104,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)