@bhsd/nodejs 1.0.1 → 1.2.0

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './replace.js';
 /**
  * 进行性能分析，生成prof.json和prof-summary.json文件
  * @param callback 要分析的函数
@@ -29,3 +30,8 @@ export declare const red: (str: string) => string;
  * @param str 要显示的字符串
  */
 export declare const blue: (str: string) => string;
+/**
+ * 将字符串以灰色显示
+ * @param str 要显示的字符串
+ */
+export declare const gray: (str: string) => string;

package/dist/index.js

@@ -2,6 +2,7 @@ import * as fs from 'fs';
 import * as path from 'path';
 import { Session } from 'inspector/promises';
 import { styleText } from 'util';
+export * from './replace.js';
 /**
  * Adds the ticks to the myTicks object.
  * @param myTicks ticks记录对象
@@ -75,3 +76,8 @@ export const red = (str) => styleText('red', str);
  * @param str 要显示的字符串
  */
 export const blue = (str) => styleText('blue', str);
+/**
+ * 将字符串以灰色显示
+ * @param str 要显示的字符串
+ */
+export const gray = (str) => styleText('gray', str);

package/dist/replace.d.ts

@@ -0,0 +1,21 @@
+export declare class ReplacableString {
+    input: string;
+    /** @param input 要替换的字符串 */
+    constructor(input: string);
+    /**
+     * 替换并确认
+     * @param searchValue 查找的字符串或正则表达式
+     * @param replaceValue 替换的字符串
+     * @param g 是否全局正则表达式
+     * @throws `RangeError` 查找全局正则表达式
+     */
+    replace(searchValue: string | RegExp, replaceValue: string, g?: boolean): this;
+    /**
+     * 替换全部并检查替换次数
+     * @param searchValue 查找的字符串或正则表达式
+     * @param replaceValue 替换的字符串
+     * @param count 预期替换的次数
+     * @throws `RangeError` 查找的不是字符串或全局正则表达式
+     */
+    replaceAll(searchValue: string | RegExp, replaceValue: string, count: number): this;
+}

package/dist/replace.js

@@ -0,0 +1,46 @@
+import * as assert from 'assert';
+export class ReplacableString {
+    input;
+    /** @param input 要替换的字符串 */
+    constructor(input) {
+        this.input = input;
+    }
+    /**
+     * 替换并确认
+     * @param searchValue 查找的字符串或正则表达式
+     * @param replaceValue 替换的字符串
+     * @param g 是否全局正则表达式
+     * @throws `RangeError` 查找全局正则表达式
+     */
+    replace(searchValue, replaceValue, g) {
+        if (!g && typeof searchValue === 'object' && searchValue.global) {
+            throw new RangeError('search value must not be a global RegExp', { cause: searchValue });
+        }
+        const { input } = this;
+        this.input = input.replace(searchValue, replaceValue);
+        assert.notStrictEqual(this.input, input, `replace failed: ${searchValue}`);
+        return this;
+    }
+    /**
+     * 替换全部并检查替换次数
+     * @param searchValue 查找的字符串或正则表达式
+     * @param replaceValue 替换的字符串
+     * @param count 预期替换的次数
+     * @throws `RangeError` 查找的不是字符串或全局正则表达式
+     */
+    replaceAll(searchValue, replaceValue, count) {
+        const { input } = this, msg = `replaceAll failed: ${searchValue}`;
+        if (typeof searchValue === 'string') {
+            assert.strictEqual(input.split(searchValue).length - 1, count, msg);
+        }
+        else if (searchValue.global) {
+            // eslint-disable-next-line regexp/prefer-regexp-exec
+            assert.strictEqual(input.match(searchValue)?.length, count, msg);
+        }
+        else {
+            throw new RangeError('search value must be a string or a global RegExp', { cause: searchValue });
+        }
+        this.input = input.replaceAll(searchValue, replaceValue);
+        return this;
+    }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@bhsd/nodejs",
-	"version": "1.0.1",
+	"version": "1.2.0",
 	"homepage": "https://github.com/bhsd-harry/nodejs#readme",
 	"bugs": {
 		"url": "https://github.com/bhsd-harry/nodejs/issues"
@@ -21,10 +21,8 @@
 		"lint": "npm run lint:ts"
 	},
 	"devDependencies": {
-		"@bhsd/code-standard": "^2.5.0",
-		"@types/node": "^25.9.0",
-		"@typescript-eslint/parser": "^8.59.4",
-		"eslint": "^10.4.0",
+		"@bhsd/code-standard": "^3.1.0",
+		"eslint": "^10.6.0",
 		"typescript": "^6.0.3"
 	},
 	"engines": {