dolphindb 3.0.209 → 3.0.211

package/README.md

@@ -607,6 +607,11 @@ export interface StreamingMessage <TRows = any> extends StreamingParams {
 }
 ```
 
+To close streaming data subscription, use the following two methods to disconnect:
+- Automatically disconnect by closing the browser page
+- Manually disconnect by calling `sddb.disconnect()`
+
+
 ## Development Method
 
 ```shell

package/README.zh.md

@@ -589,6 +589,10 @@ export interface StreamingMessage <TRows = any> extends StreamingParams {
 }
 ```
 
+关闭流数据订阅使用下面两种断开连接的方法
+- 关闭浏览器页面自动断开连接
+- 调用 `sddb.disconnect()` 手动断开连接
+
 
 ### 开发方法
 

package/browser.d.ts

@@ -281,6 +281,7 @@ export interface DdbMatrixData {
 }
 export type IotVectorItemValue = [number | string | bigint | boolean][];
 export type DdbIotAnyVector = DdbObj<IotVectorItemValue>;
+export type Convertable = DdbObj | string | boolean | null | undefined;
 /** 可以表示所有 DolphinDB 数据库中的数据类型  Can represent data types in all DolphinDB databases */
 export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     static dec: TextDecoder;
@@ -357,10 +358,10 @@ export declare class DdbObj<TValue extends DdbValue = DdbValue> {
     }, limit?: number): TensorData;
     toString(options?: InspectOptions): string;
     inspect_type(): string;
-    /** 自动转换 js string, boolean 为 DdbObj */
-    static to_ddbobj(value: DdbObj | string | boolean): DdbObj;
+    /** 自动转换 Convertable 为 DdbObj */
+    static to_ddbobj(value: Convertable): DdbObj;
     /** 转换 js 数组为 DdbObj[] */
-    static to_ddbobjs(values: (DdbObj | string | boolean)[]): DdbObj<DdbValue>[];
+    static to_ddbobjs(values: Convertable[]): DdbObj<DdbValue>[];
     /** @deprecated 用 data() */
     to_cols(): {
         title: string;
@@ -418,9 +419,10 @@ export interface ConvertOptions {
     /** `'ms'` timestamp 类型转换为字符串表示时显示到秒还是毫秒 */
     timestamp?: 's' | 'ms';
 }
-export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | number[] | Uint8Array<ArrayBufferLike> | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | BigInt128Array | string[] | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbSymbolExtendedValue | DdbArrayVectorValue | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | DdbDurationVectorValue | DdbMatrixValue | DdbChartValue | DdbTensorValue;
+export declare function convert(type: DdbType, value: DdbValue, le: boolean, { blob, char, timestamp }?: ConvertOptions): string | number | bigint | boolean | DdbFunctionDefValue | DdbDurationValue | DdbDecimal32Value | DdbDecimal64Value | DdbDecimal32VectorValue | DdbDecimal64VectorValue | DdbDecimal128VectorValue | BigInt128Array | DdbSymbolExtendedValue | string[] | DdbArrayVectorValue | DdbMatrixValue | Uint8Array<ArrayBufferLike> | Int8Array<ArrayBufferLike> | Int16Array<ArrayBufferLike> | Int32Array<ArrayBufferLike> | Float32Array<ArrayBufferLike> | Float64Array<ArrayBufferLike> | BigInt64Array<ArrayBufferLike> | Uint8Array<ArrayBufferLike>[] | DdbObj<DdbValue>[] | IotVectorItemValue | DdbDurationVectorValue | number[] | DdbTensorValue | DdbChartValue;
 /** 转换一个向量到 js 原生数组 */
 export declare function converts(type: DdbType, value: DdbVectorValue, rows: number, le: boolean, options?: ConvertOptions): any[] | Uint8Array;
+/** 构造 void 类型，默认为 `DdbVoidType.undefined` */
 export declare class DdbVoid extends DdbObj<undefined> {
     constructor(value?: DdbVoidType);
 }

package/browser.js

@@ -1549,10 +1549,14 @@ export class DdbObj {
                 return `${DdbForm[this.form]} ${tname}`;
         }
     }
-    /** 自动转换 js string, boolean 为 DdbObj */
+    /** 自动转换 Convertable 为 DdbObj */
     static to_ddbobj(value) {
         if (value && value instanceof DdbObj)
             return value;
+        if (value === undefined)
+            return new DdbVoid();
+        if (value === null)
+            return new DdbVoid(DdbVoidType.null);
         const type = typeof value;
         switch (type) {
             case 'string':
@@ -2148,6 +2152,7 @@ export function converts(type, value, rows, le, options) {
         }).flat();
     }
 }
+/** 构造 void 类型，默认为 `DdbVoidType.undefined` */
 export class DdbVoid extends DdbObj {
     constructor(value = DdbVoidType.undefined) {
         super({
@@ -3295,20 +3300,23 @@ export class DDB {
     async invoke(func, args, options) {
         // 检查 args 是否全部为简单参数，是则直接调用 call，避免 invoke 间接调用
         // 逻辑类似 DdbObj.to_ddbobjs, 需要同步修改
-        let simple = true;
+        let convertable = true;
         let has_ddbobj = false;
         if (args)
             for (const arg of args)
                 if (arg && arg instanceof DdbObj)
                     has_ddbobj = true;
+                else if (arg === undefined || arg === null) {
+                    // simple
+                }
                 else {
                     const type = typeof arg;
-                    if (type === 'string' || type === 'boolean') { }
+                    if (type === 'string' || type === 'boolean') { } // simple
                     else
-                        simple = false;
+                        convertable = false;
                 }
         let result;
-        if (simple)
+        if (convertable)
             result = await this.call(func, args, options);
         else {
             if (has_ddbobj)
@@ -3396,15 +3404,10 @@ export class DDB {
         /** index of line feed 0 */
         const ilf0 = buf.indexOf(0x0a); // '\n'
         const parts = this.dec.decode(buf.subarray(0, ilf0)).split(' ');
-        /** session id */
-        const sid = parts[0];
-        if (sid !== this.sid) {
-            console.log(t('session id 从 {{sid}} 变为 {{sid_}}', { sid: this.sid, sid_: sid }));
-            this.sid = sid;
-        }
-        /** 返回对象的数量 */
-        const nobj = Number(parts[1]);
-        /** 大小端: 协议中大端为 0, 小端为 1 */
+        this.sid = parts[0];
+        // 返回对象的数量
+        // const nobj = Number(parts[1])
+        // 大小端: 协议中大端为 0, 小端为 1
         this.le = Number(parts[2]) !== 0;
         const ils1 = ilf0 + 1;
         const ilf1 = buf.indexOf(0x0a, ils1); // '\n'