dolphindb 3.0.113 → 3.0.115

package/browser.d.ts

@@ -549,8 +549,13 @@ export declare function int1282str(buffer: Uint8Array, le?: boolean): string;
 export interface StreamingParams {
     table: string;
     action?: string;
+    /** offset 是订阅任务开始后的第一条消息所在的位置。消息是流数据表中的行。
+        如果未指定，或设为-1，订阅将会从流数据表的当前行开始。
+        如果 offset = -2，系统会获取持久化到磁盘上的 offset，并从该位置开始订阅。注意：须同时设置 persistOffset = true，offset = -2 才会生效；否则 offset 会变为 -1。
+        offset 与流数据表创建时的第一行对应。如果某些行因为内存限制被删除，在决定订阅开始的位置时，这些行仍然考虑在内。 */
+    offset?: number;
     filters?: {
-        /** https://docs.dolphindb.cn/zh/help/FunctionsandCommands/FunctionReferences/s/subscribeTable.html#:~:text=%E8%BF%9E%E6%8E%A5%E6%96%B0%E7%9A%84%20leader%E3%80%82-,filter%20%E5%8F%82%E6%95%B0%E9%9C%80%E8%A6%81%E9%85%8D%E5%90%88,-setStreamTableFilterColumn%20%E5%87%BD%E6%95%B0%E4%B8%80%E8%B5%B7 */
+        /** https://test.dolphindb.cn/zh/funcs/s/subscribeTable.html#:~:text=filter%20%E5%8F%82%E6%95%B0%E9%9C%80%E8%A6%81%E9%85%8D%E5%90%88%20setStreamTableFilterColumn%20%E5%87%BD%E6%95%B0%E4%B8%80%E8%B5%B7%E4%BD%BF%E7%94%A8 */
         column?: DdbObj;
         /** 过滤条件的 DolphinDB 表达式 https://dolphindb1.atlassian.net/wiki/spaces/dev/pages/760840447/WebSocketConsole */
         expression?: string;
@@ -590,6 +595,8 @@ export interface DdbEvalOptions {
     listener?: DdbMessageListener;
     parse_object?: boolean;
 }
+export interface DdbExecuteOptions extends DdbEvalOptions, ConvertOptions {
+}
 type DdbRpcType = 'script' | 'function' | 'variable' | 'connect';
 export interface DdbRpcOptions extends DdbEvalOptions {
     script?: string;
@@ -637,6 +644,8 @@ export interface DdbCallOptions extends DdbEvalOptions {
     skip_connection_check?: boolean;
     on_more_messages?: DdbRpcOptions['on_more_messages'];
 }
+export interface DdbInvokeOptions extends DdbCallOptions, ConvertOptions {
+}
 export declare class DDB {
     /** 当前的 session id (http 或 tcp) */
     sid: string;
@@ -813,13 +822,13 @@ export declare class DDB {
             - func_type?: 设置 node 参数且参数数组为空时必传，需指定函数类型，其它情况下不传
             - add_node_alias?: 设置 nodes 参数时选传，其它情况不传
             - listener?: 处理本次 rpc 期间的消息 (DdbMessage) */
-    invoke<TResult = any>(func: string, args?: any[], options?: DdbCallOptions): Promise<TResult>;
+    invoke<TResult = any>(func: string, args?: any[], options?: DdbInvokeOptions): Promise<TResult>;
     /** 执行 dolphindb 脚本，返回 js 原生对象或值（调用 DdbObj.data() 后的结果）
         - script?: 执行的脚本
         - options?: 执行选项
             - urgent?: 紧急 flag，确保提交的脚本使用 urgent worker 处理，防止被其它作业阻塞
             - listener?: 处理本次 rpc 期间的消息 (DdbMessage) */
-    execute<TResult = any>(script: string, options?: DdbEvalOptions): Promise<TResult>;
+    execute<TResult = any>(script: string, options?: DdbExecuteOptions): Promise<TResult>;
     /** upload variable through websocket (variable command) */
     upload(
     /** 上传的变量名  Uploaded variables' name */

package/browser.js

@@ -3221,7 +3221,7 @@ export class DDB {
         const result = simple
             ? await this.call(func, args, options)
             : await this.call('invoke', [func, JSON.stringify(args)], options);
-        return result.data();
+        return result.data(options);
     }
     /** 执行 dolphindb 脚本，返回 js 原生对象或值（调用 DdbObj.data() 后的结果）
         - script?: 执行的脚本
@@ -3230,7 +3230,7 @@ export class DDB {
             - listener?: 处理本次 rpc 期间的消息 (DdbMessage) */
     async execute(script, options) {
         return (await this.eval(script, options))
-            .data();
+            .data(options);
     }
     /** upload variable through websocket (variable command) */
     async upload(
@@ -3330,10 +3330,10 @@ export class DDB {
             new DdbInt(0),
             this.streaming.table,
             (this.streaming.action ||= `api_js_${new Date().getTime()}`),
-            ...this.streaming?.filters?.column ? [
-                new DdbVoid(), // offset
-                this.streaming.filters.column // filter
-            ] : []
+            (this.streaming.offset === undefined || this.streaming.offset === null)
+                ? new DdbVoid()
+                : new DdbInt(this.streaming.offset), // offset
+            this.streaming.filters?.column || new DdbVoid(), // filter
         ], {
             skip_connection_check: true,
             // 先准备好收到 websocket message 的 callback