@bhsd/nodejs 1.0.0 → 1.1.0

package/README.md

@@ -1,4 +1,4 @@
 # @bhsd/nodejs
 
 [![npm version](https://badge.fury.io/js/@bhsd%2Fnodejs.svg)](https://www.npmjs.com/package/@bhsd/nodejs)
-[![License](https://img.shields.io/badge/License-MIT-brightgreen.svg)](LICENSE)
+[![CodeQL](https://github.com/bhsd-harry/nodejs/actions/workflows/codeql.yml/badge.svg)](https://github.com/bhsd-harry/nodejs/actions/workflows/codeql.yml)

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+export * from './replace.js';
 /**
  * 进行性能分析，生成prof.json和prof-summary.json文件
  * @param callback 要分析的函数

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记录对象

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.0",
+	"version": "1.1.0",
 	"homepage": "https://github.com/bhsd-harry/nodejs#readme",
 	"bugs": {
 		"url": "https://github.com/bhsd-harry/nodejs/issues"
@@ -14,26 +14,16 @@
 	"types": "./dist/index.d.ts",
 	"type": "module",
 	"scripts": {
+		"ls": "npm i --package-lock-only && npm ls --package-lock-only --all --omit=dev",
 		"prepublishOnly": "npm run build",
 		"build": "tsc",
 		"lint:ts": "tsc --noEmit && eslint --cache .",
 		"lint": "npm run lint:ts"
 	},
 	"devDependencies": {
-		"@bhsd/code-standard": "^2.1.1",
-		"@stylistic/eslint-plugin": "^5.10.0",
-		"@types/node": "^24.11.0",
-		"@typescript-eslint/eslint-plugin": "^8.57.0",
-		"@typescript-eslint/parser": "^8.57.0",
-		"eslint": "^9.39.4",
-		"eslint-plugin-eslint-comments": "^3.2.0",
-		"eslint-plugin-jsdoc": "^62.7.1",
-		"eslint-plugin-jsonc": "^3.1.1",
-		"eslint-plugin-n": "^17.24.0",
-		"eslint-plugin-promise": "^7.2.1",
-		"eslint-plugin-regexp": "^3.1.0",
-		"eslint-plugin-unicorn": "^63.0.0",
-		"typescript": "^5.9.3"
+		"@bhsd/code-standard": "^3.0.0",
+		"eslint": "^10.5.0",
+		"typescript": "^6.0.3"
 	},
 	"engines": {
 		"node": "^20.19.0 || ^22.13.0 || >=24.11.0"