feat!: lightweight joinURL + resolveURL

README.md

@@ -60,7 +60,11 @@ normalizeURL('http://localhost:3000')
 ```ts
 // Result: a/b/c
 joinURL('a', '/b', '/c')
+```
+
+### `resolveURL`
 
+```ts
 // Result: http://foo.com/foo/bar/baz?test=123#token
 joinURL('http://foo.com/foo?test=123#token', 'bar', 'baz')
 ```

src/utils.ts

@@ -41,6 +41,16 @@ export function getParams (input: string): ParamsObject {
 }
 
 export function joinURL (base: string, ...input: string[]): string {
+  let url = base || ''
+
+  for (const i of input) {
+    url = withTrailingSlash(url) + withoutLeadingSlash(i)
+  }
+
+  return url
+}
+
+export function resolveURL (base: string, ...input: string[]): string {
   const url = createURL(base)
 
   for (const i of input) {

test/join.test.ts

@@ -8,10 +8,7 @@ describe('joinURL', () => {
     { input: ['/a'], out: '/a' },
     { input: ['a', 'b'], out: 'a/b' },
     { input: ['a', 'b/', 'c'], out: 'a/b/c' },
-    { input: ['a', 'b/', '/c'], out: 'a/b/c' },
-    { input: ['/a?foo=bar#123', 'b/', 'c/'], out: '/a/b/c/?foo=bar#123' },
-    { input: ['http://foo.com', 'a'], out: 'http://foo.com/a' },
-    { input: ['a?x=1', 'b?y=2&y=3&z=4'], out: 'a/b?x=1&y=2&y=3&z=4' }
+    { input: ['a', 'b/', '/c'], out: 'a/b/c' }
   ]
 
   for (const t of tests) {
@@ -20,14 +17,6 @@ describe('joinURL', () => {
     })
   }
 
-  test('invalid URL (null)', () => {
-    expect(() => joinURL(null)).toThrow('URL input should be string received object (null)')
-  })
-
-  test('invalid URL (array)', () => {
-    expect(() => joinURL([])).toThrow('URL input should be string received object ()')
-  })
-
   test('no arguments', () => {
     expect(joinURL()).toBe('')
   })

test/resolve.test.ts

@@ -0,0 +1,34 @@
+// @ts-nocheck
+import { resolveURL } from '../src'
+
+describe('resolveURL', () => {
+  const tests = [
+    { input: [], out: '' },
+    { input: ['/'], out: '/' },
+    { input: ['/a'], out: '/a' },
+    { input: ['a', 'b'], out: 'a/b' },
+    { input: ['a', 'b/', 'c'], out: 'a/b/c' },
+    { input: ['a', 'b/', '/c'], out: 'a/b/c' },
+    { input: ['/a?foo=bar#123', 'b/', 'c/'], out: '/a/b/c/?foo=bar#123' },
+    { input: ['http://foo.com', 'a'], out: 'http://foo.com/a' },
+    { input: ['a?x=1', 'b?y=2&y=3&z=4'], out: 'a/b?x=1&y=2&y=3&z=4' }
+  ]
+
+  for (const t of tests) {
+    test(t.input.toString(), () => {
+      expect(resolveURL(...t.input)).toBe(t.out)
+    })
+  }
+
+  test('invalid URL (null)', () => {
+    expect(() => resolveURL(null)).toThrow('URL input should be string received object (null)')
+  })
+
+  test('invalid URL (array)', () => {
+    expect(() => resolveURL([])).toThrow('URL input should be string received object ()')
+  })
+
+  test('no arguments', () => {
+    expect(resolveURL()).toBe('')
+  })
+})