dolphindb 2.0.915 → 2.0.917

package/browser.d.ts

@@ -8,14 +8,15 @@ export declare enum DdbForm {
     dict = 5,
     table = 6,
     chart = 7,
-    /** 结点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型  Node internal communication may be used, calling function execution script generally does not return this type */
+    /** 结点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型
+        Node internal communication may be used, calling function execution script generally does not return this type */
     chunk = 8,
     /** sysobj */
     object = 9
 }
 /** DolphinDB DataType
-     对应的 array vector 类型为 64 + 基本类型  The corresponding array vector type is 64 + base type
-     对应的 extended 类型为 128 + 基本类型  The corresponding extended type is 128 + base type
+    对应的 array vector 类型为 64 + 基本类型  The corresponding array vector type is 64 + base type
+    对应的 extended 类型为 128 + 基本类型  The corresponding extended type is 128 + base type
 */
 export declare enum DdbType {
     void = 0,
@@ -96,13 +97,13 @@ export interface DdbDurationValue {
 export interface DdbDecimal32Value {
     /** int32, data 需要除以 10^scale 得到原值  data needs to be divided by 10^scale to get the original value */
     scale: number;
-    /** int32, 空值为 null */
+    /** int32, 空值为 null  ddb null is js null */
     data: number | null;
 }
 export interface DdbDecimal64Value {
     /** int32, data 需要除以 10^scale 得到原值  data needs to be divided by 10^scale to get the original value */
     scale: number;
-    /** int64, 空值为 null */
+    /** int64, 空值为 null  empty value is null */
     data: bigint | null;
 }
 export interface DdbDecimal32VectorValue {
@@ -145,7 +146,7 @@ export declare enum DdbChartType {
     kline = 8
 }
 export interface DdbChartValue {
-    /** 原属性 chartType */
+    /** 原属性 chartType  original: chartType */
     type: DdbChartType;
     stacking: boolean;
     /** 直方图 (Histogram), plotHist 函数返回的 chart 可能具有该属性
@@ -196,7 +197,7 @@ export declare const nulls: {
     readonly double: number;
     readonly bytes16: Uint8Array;
 };
-/** 可以表示所有 DolphinDB 数据库中的数据类型 */
+/** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     static dec: TextDecoder;
     static enc: TextEncoder;
@@ -228,7 +229,8 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     rows?: number;
     /** 第 2 维 */
     cols?: number;
-    /** 实际数据。不同的 DdbForm, DdbType 使用 DdbValue 中不同的类型来表示实际数据 */
+    /** 实际数据。不同的 DdbForm, DdbType 使用 DdbValue 中不同的类型来表示实际数据
+        The actual data. Different DdbForm, DdbType use different types in DdbValue to represent actual data */
     value: TValue;
     /** 原始二进制数据，仅在 parse_object 为 false 时通过 parse_message 生成的顶层对象有这个属性 */
     buffer?: Uint8Array;
@@ -262,11 +264,12 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     }[];
     to_rows<T extends Record<string, any> = Record<string, any>>(): T[];
     /** 将 dict<string, any> 自动转换为 js object (Record<string, any>)  Automatically convert dict<string, any> to js object (Record<string, any>)
-         - options?:
-             - strip?: `false` 是否将 DdbObj 中的 value 直接提取、剥离出来作为 js object 的 value (丢弃 DdbObj 中的其余信息，只保留 value)
-                 Whether to directly extract and strip the value in DdbObj as the value of js object (discard the rest of the information in DdbObj, only keep the value)
-             - deep?: `false` 是否递归转换  whether to convert recursively
-     */
+        - options?:
+            - strip?: `false` 是否将 DdbObj 中的 value 直接提取、剥离出来作为 js object 的 value (丢弃 DdbObj 中的其余信息，只保留 value)
+                Whether to directly extract and strip the value in DdbObj as the value of js object (discard the rest of the information in DdbObj, only keep the value)
+            - deep?: `false` 是否递归转换
+                Whether to convert recursively
+    */
     to_dict<T extends Record<string, DdbObj> = Record<string, DdbObj>>(): T;
     to_dict<T extends Record<string, any> = Record<string, any>>(options: {
         strip: true;
@@ -450,9 +453,25 @@ export interface StreamingData extends StreamingParams {
     error?: Error;
 }
 export declare const winsize: 100000;
-export declare class ConnectionError extends Error {
+type DdbRpcType = 'script' | 'function' | 'variable' | 'connect';
+export interface DdbRpcOptions {
+    script?: string;
+    func?: string;
+    args?: (DdbObj | string | boolean)[];
+    vars?: string[];
+    urgent?: boolean;
+    listener?: DdbMessageListener;
+    parse_object?: boolean;
+}
+export declare class DdbConnectionError extends Error {
+    ddb: DDB;
+    constructor(ddb: DDB, error_options?: ErrorOptions);
+}
+export declare class DdbDatabaseError extends Error {
     ddb: DDB;
-    constructor(ddb: DDB);
+    type: DdbRpcType;
+    options: DdbRpcOptions;
+    constructor(message: string, ddb: DDB, type: DdbRpcType, options: DdbRpcOptions);
 }
 export declare class DDB {
     /** 当前的 session id (http 或 tcp) */
@@ -550,8 +569,8 @@ export declare class DDB {
     }): string;
     disconnect(): void;
     /** rpc through websocket (function/script/variable command)
-        未连接到 DDB 时调用会自动连接，连接断开时调用会抛出 ConnectionError
-        When the DDB is not connected, the call will be automatically connected. When the connection is disconnected, the call will throw the Connectionerror
+        未连接到 DDB 时调用会自动连接，连接断开时调用会抛出 DdbConnectionError
+        When the DDB is not connected, the call will be automatically connected. When the connection is disconnected, the call will throw the DdbConnectionError
         - type: API 类型: 'script' | 'function' | 'variable'
         - options:
             - urgent?: 决定 `行为标识` 那一行字符串的取值（只适用于 script 和 function）
@@ -560,15 +579,7 @@ export declare class DDB {
             - parse_object?: 在本次 rpc 期间设置 parse_object, 结束后恢复原有
                 为 false 时返回的 DdbObj 仅含有 buffer 和 le，不做解析，以便后续转发、序列化
     */
-    rpc<T extends DdbObj = DdbObj>(type: 'script' | 'function' | 'variable' | 'connect', { script, func, args, vars, urgent, listener, parse_object, }: {
-        script?: string;
-        func?: string;
-        args?: (DdbObj | string | boolean)[];
-        vars?: string[];
-        urgent?: boolean;
-        listener?: DdbMessageListener;
-        parse_object?: boolean;
-    }): Promise<T>;
+    rpc<T extends DdbObj = DdbObj>(type: DdbRpcType, options: DdbRpcOptions): Promise<T>;
     /** eval script through websocket (script command)
         - script?: 执行的脚本  Script to execute
         - options?: 执行选项  execution options
@@ -630,7 +641,7 @@ export declare class DDB {
     /** 取消当前 session id 对应的所有 console jobs  Cancel all console jobs corresponding to the current session id */
     cancel(): Promise<void>;
     /** 解析服务端响应报文，返回去掉 header 的 data buf */
-    parse_message(buf: Uint8Array, parse_object?: boolean): DdbMessage;
+    parse_message(buf: Uint8Array, error: DdbDatabaseError): DdbMessage;
     /** 内部的流订阅方法  Internal stream subscription method */
     subscribe(): Promise<StreamingData>;
 }
@@ -651,3 +662,4 @@ export interface DdbErrorMessage {
 }
 export type DdbMessage = DdbPrintMessage | DdbObjectMessage | DdbErrorMessage;
 export declare let ddb: DDB;
+export {};

package/browser.js

@@ -18,14 +18,15 @@ export var DdbForm;
     DdbForm[DdbForm["dict"] = 5] = "dict";
     DdbForm[DdbForm["table"] = 6] = "table";
     DdbForm[DdbForm["chart"] = 7] = "chart";
-    /** 结点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型  Node internal communication may be used, calling function execution script generally does not return this type */
+    /** 结点内部通信可能会使用，调用函数执行脚本一般不会返回这种类型
+        Node internal communication may be used, calling function execution script generally does not return this type */
     DdbForm[DdbForm["chunk"] = 8] = "chunk";
     /** sysobj */
     DdbForm[DdbForm["object"] = 9] = "object";
 })(DdbForm = DdbForm || (DdbForm = {}));
 /** DolphinDB DataType
-     对应的 array vector 类型为 64 + 基本类型  The corresponding array vector type is 64 + base type
-     对应的 extended 类型为 128 + 基本类型  The corresponding extended type is 128 + base type
+    对应的 array vector 类型为 64 + 基本类型  The corresponding array vector type is 64 + base type
+    对应的 extended 类型为 128 + 基本类型  The corresponding extended type is 128 + base type
 */
 export var DdbType;
 (function (DdbType) {
@@ -119,7 +120,7 @@ export const nulls = {
     double: -Number.MAX_VALUE,
     bytes16: Uint8Array.from(new Array(16).fill(0))
 };
-/** 可以表示所有 DolphinDB 数据库中的数据类型 */
+/** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export class DdbObj {
     static dec = new TextDecoder('utf-8');
     static enc = new TextEncoder();
@@ -151,7 +152,8 @@ export class DdbObj {
     rows;
     /** 第 2 维 */
     cols;
-    /** 实际数据。不同的 DdbForm, DdbType 使用 DdbValue 中不同的类型来表示实际数据 */
+    /** 实际数据。不同的 DdbForm, DdbType 使用 DdbValue 中不同的类型来表示实际数据
+        The actual data. Different DdbForm, DdbType use different types in DdbValue to represent actual data */
     value;
     /** 原始二进制数据，仅在 parse_object 为 false 时通过 parse_message 生成的顶层对象有这个属性 */
     buffer;
@@ -2119,13 +2121,24 @@ export function int1282str(buffer, le = true) {
         .padStart(2, '0')).join('');
 }
 export const winsize = 10_0000;
-export class ConnectionError extends Error {
+export class DdbConnectionError extends Error {
     ddb;
-    constructor(ddb) {
-        super(`${ddb.url} ${t('已断开')}`);
+    constructor(ddb, error_options) {
+        super(`${ddb.url} ${t('已断开')}`, error_options);
         this.ddb = ddb;
     }
 }
+export class DdbDatabaseError extends Error {
+    ddb;
+    type;
+    options;
+    constructor(message, ddb, type, options) {
+        super(message);
+        this.ddb = ddb;
+        this.type = type;
+        this.options = options;
+    }
+}
 export class DDB {
     /** 当前的 session id (http 或 tcp) */
     sid = '0';
@@ -2290,8 +2303,8 @@ export class DDB {
             this.websocket.close(1000);
     }
     /** rpc through websocket (function/script/variable command)
-        未连接到 DDB 时调用会自动连接，连接断开时调用会抛出 ConnectionError
-        When the DDB is not connected, the call will be automatically connected. When the connection is disconnected, the call will throw the Connectionerror
+        未连接到 DDB 时调用会自动连接，连接断开时调用会抛出 DdbConnectionError
+        When the DDB is not connected, the call will be automatically connected. When the connection is disconnected, the call will throw the DdbConnectionError
         - type: API 类型: 'script' | 'function' | 'variable'
         - options:
             - urgent?: 决定 `行为标识` 那一行字符串的取值（只适用于 script 和 function）
@@ -2300,11 +2313,13 @@ export class DDB {
             - parse_object?: 在本次 rpc 期间设置 parse_object, 结束后恢复原有
                 为 false 时返回的 DdbObj 仅含有 buffer 和 le，不做解析，以便后续转发、序列化
     */
-    async rpc(type, { script, func, args = [], vars = [], urgent, listener, parse_object, }) {
+    async rpc(type, options) {
         if (!this.websocket)
             await this.connect();
         if (!this.connected)
-            throw new ConnectionError(this);
+            throw new DdbConnectionError(this);
+        const { script, func, vars = [], urgent, listener, } = options;
+        let { args = [] } = options;
         if (func === 'pnode_run' && !this.pnode_run_defined) {
             // 保证并发调用 rpc 时只定义一次 pnode_run
             const ptail = this.ppnoderun;
@@ -2357,6 +2372,7 @@ export class DDB {
         }
         // this 上的当前配置需要在 message 到达后使用，先保存起来
         const _handlers = [...this.listeners].reverse();
+        let error = new DdbDatabaseError('', this, type, options);
         // 临界区：保证多个 rpc 并发时形成 promise 链
         // ddb 世界观：需要等待上一个 rpc 结果从 server 返回之后才能发起下一个调用  
         // 违反世界观可能造成:  
@@ -2379,7 +2395,7 @@ export class DDB {
                 const buf = new Uint8Array(buffer);
                 if (this.print_message_buffer)
                     console.log(buf);
-                const message = this.parse_message(buf, parse_object);
+                const message = this.parse_message(buf, error);
                 listener?.(message, this);
                 for (const listener of _handlers)
                     listener(message, this);
@@ -2522,7 +2538,7 @@ export class DDB {
         }
     }
     /** 解析服务端响应报文，返回去掉 header 的 data buf */
-    parse_message(buf, parse_object = this.parse_object) {
+    parse_message(buf, error) {
         // MSG\n
         // <message>\0
         // 'M'.codePointAt(0).to_hex_str()
@@ -2555,17 +2571,16 @@ export class DDB {
         const ilf1 = buf.indexOf(0x0a, ils1); // '\n'
         /** 'OK' 表示成功，其它文本表示失败 */
         const message = this.dec.decode(buf.subarray(ils1, ilf1));
-        if (message !== 'OK')
-            return {
-                type: 'error',
-                data: new Error(message)
-            };
+        if (message !== 'OK') {
+            error.message = message;
+            return { type: 'error', data: error };
+        }
         const bufobj = buf.subarray(ilf1 + 1);
         if (this.print_object_buffer)
             console.log(bufobj);
         return {
             type: 'object',
-            data: parse_object ?
+            data: error.options.parse_object ?? this.parse_object ?
                 DdbObj.parse(bufobj, this.le)
                 :
                     new DdbObj({