feat: add urlJoin method

Author: jooy2

CHANGELOG.md

@@ -3,6 +3,7 @@
 ## 1.3.3 (2024--)
 
 - `objFindItemRecursiveByKey`: Add `objFindItemRecursiveByKey` method
+- `urlJoin`: Add `urlJoin` method
 
 ## 1.3.2 (2023-12-28)
 

docs/src/methods/string.md

@@ -490,3 +490,21 @@ Converts the given string to ascii code and returns it as an array.
 ```javascript
 _.strToAscii('12345'); // Returns [49, 50, 51, 52, 53]
 ```
+
+## `_.urlJoin`
+
+Merges the given string argument with the first argument (the beginning of the URL), joining it so that the slash (`/`) symbol is correctly included.
+
+### Parameters
+
+- `args::string[]`
+
+### Returns
+
+> string
+
+### Examples
+
+```javascript
+_.urlJoin('https://example.com', 'hello', 'world'); // Returns 'https://example.com/hello/world'
+```

lib/index.ts

@@ -836,6 +836,30 @@ export default class Qsu {
 		return [...new Set(str)].join('');
 	}
 
+	static urlJoin(...args: string[]): string {
+		if (!args) {
+			return '';
+		}
+
+		const argLength = args.length;
+		let urlResult = '';
+
+		for (let i = 0; i < argLength; i += 1) {
+			if (
+				i === 0 ||
+				args[i].startsWith('/') ||
+				args[i].startsWith('?') ||
+				args[i].startsWith('&')
+			) {
+				urlResult += args[i];
+			} else {
+				urlResult += `/${args[i]}`;
+			}
+		}
+
+		return urlResult;
+	}
+
 	/*
 	 * Verify
 	 * */
@@ -1096,6 +1120,7 @@ export const {
 	strToNumberHash,
 	strUnique,
 	strToAscii,
+	urlJoin,
 	isObject,
 	isEqual,
 	isEqualStrict,

test/string.spec.ts

@@ -24,7 +24,8 @@ import {
 	strToNumberHash,
 	strUnique,
 	strToAscii,
-	objectId
+	objectId,
+	urlJoin
 } from '../dist';
 
 describe('String', () => {
@@ -240,4 +241,21 @@ st`),
 		assert.strictEqual(objectId().length, 24);
 		done();
 	});
+
+	it('urlJoin', (done) => {
+		assert.strictEqual(
+			urlJoin('https://example.com', 'hello', 'world'),
+			'https://example.com/hello/world'
+		);
+		assert.strictEqual(
+			urlJoin('https://example.com', '/hello', '/world', 'bye'),
+			'https://example.com/hello/world/bye'
+		);
+		assert.strictEqual(
+			urlJoin('example.com', '/hello', '/world', 'bye'),
+			'example.com/hello/world/bye'
+		);
+		assert.strictEqual(urlJoin('hello', '/world', 'bye'), 'hello/world/bye');
+		done();
+	});
 });