xshell 1.0.165 → 1.0.166

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "xshell",
-    "version": "1.0.165",
+    "version": "1.0.166",
     "type": "module",
     "main": "./index.js",
     "bin": {

package/utils.browser.d.ts

@@ -92,7 +92,13 @@ export declare class Timer {
     /** 如果秒表未停止，获取当前秒表读数；
         如果秒表已停止，获取停止时的秒表读数; */
     get(): number;
-    getstr(): string;
+    /** 获取时间表示字符串，如 1.2 s
+        - parenthesis?: `true` 字符串前后加上括号，如 (1.2 s) */
+    getstr(parenthesis?: boolean): string;
     print(): void;
+    /** 重置 started */
+    reset(): void;
+    get_and_reset(): number;
+    getstr_and_reset(parenthesis?: boolean): string;
 }
 export declare function lowercase_first_letter(str: string): string;

package/utils.browser.js

@@ -270,11 +270,32 @@ export class Timer {
     get() {
         return (this.ended || new Date().getTime()) - this.started;
     }
-    getstr() {
-        return `(${delta2str(this.get())})`;
+    /** 获取时间表示字符串，如 1.2 s
+        - parenthesis?: `true` 字符串前后加上括号，如 (1.2 s) */
+    getstr(parenthesis = false) {
+        let s = delta2str(this.get());
+        if (parenthesis)
+            return s.bracket();
+        else
+            return s;
     }
     print() {
-        console.log(this.getstr());
+        console.log(this.getstr(true));
+    }
+    /** 重置 started */
+    reset() {
+        this.started = new Date().getTime();
+        this.ended = null;
+    }
+    get_and_reset() {
+        const result = this.get();
+        this.reset();
+        return result;
+    }
+    getstr_and_reset(parenthesis) {
+        const result = this.getstr(parenthesis);
+        this.reset();
+        return result;
     }
 }
 export function lowercase_first_letter(str) {

package/utils.d.ts

@@ -61,9 +61,13 @@ export declare class Timer {
         如果秒表已停止，获取停止时的秒表读数; */
     get(): number;
     /** 获取时间表示字符串，如 1.2 s
-        - bracket?: `true` 字符串前后加上括号，如 (1.2 s) */
-    getstr(bracket?: boolean): string;
+        - parenthesis?: `true` 字符串前后加上括号，如 (1.2 s) */
+    getstr(parenthesis?: boolean): string;
     print(): void;
+    /** 重置 started */
+    reset(): void;
+    get_and_reset(): number;
+    getstr_and_reset(parenthesis?: boolean): string;
 }
 export declare function log_line(): void;
 export declare function delay(milliseconds: number, options?: TimerOptions): Promise<void>;

package/utils.js

@@ -189,10 +189,10 @@ export class Timer {
         return (this.ended || new Date().getTime()) - this.started;
     }
     /** 获取时间表示字符串，如 1.2 s
-        - bracket?: `true` 字符串前后加上括号，如 (1.2 s) */
-    getstr(bracket = false) {
+        - parenthesis?: `true` 字符串前后加上括号，如 (1.2 s) */
+    getstr(parenthesis = false) {
         let s = delta2str(this.get());
-        if (bracket)
+        if (parenthesis)
             return s.bracket();
         else
             return s;
@@ -200,6 +200,21 @@ export class Timer {
     print() {
         console.log(this.getstr(true));
     }
+    /** 重置 started */
+    reset() {
+        this.started = new Date().getTime();
+        this.ended = null;
+    }
+    get_and_reset() {
+        const result = this.get();
+        this.reset();
+        return result;
+    }
+    getstr_and_reset(parenthesis) {
+        const result = this.getstr(parenthesis);
+        this.reset();
+        return result;
+    }
 }
 export function log_line() {
     console.log('---');