feat(util): Add lightweight parseUrl function (#9019)

Co-authored-by: Rhys Arkins <rhys@arkins.net>
Co-authored-by: Michael Kriese <michael.kriese@visualon.de>

lib/util/url.spec.ts

@@ -1,4 +1,9 @@
-import { resolveBaseUrl, trimTrailingSlash, validateUrl } from './url';
+import {
+  parseUrl,
+  resolveBaseUrl,
+  trimTrailingSlash,
+  validateUrl,
+} from './url';
 
 describe('util/url', () => {
   test.each([
@@ -45,6 +50,7 @@ describe('util/url', () => {
   ])('%s + %s => %s', (baseUrl, x, result) => {
     expect(resolveBaseUrl(baseUrl, x)).toBe(result);
   });
+
   it('validates URLs', () => {
     expect(validateUrl()).toBe(false);
     expect(validateUrl(null)).toBe(false);
@@ -53,6 +59,17 @@ describe('util/url', () => {
     expect(validateUrl('http://github.com')).toBe(true);
     expect(validateUrl('https://github.com')).toBe(true);
   });
+
+  it('parses URL', () => {
+    expect(parseUrl(null)).toBeNull();
+    expect(parseUrl(undefined)).toBeNull();
+
+    const url = parseUrl('https://github.com/renovatebot/renovate');
+    expect(url.protocol).toBe('https:');
+    expect(url.host).toBe('github.com');
+    expect(url.pathname).toBe('/renovatebot/renovate');
+  });
+
   it('trimTrailingSlash', () => {
     expect(trimTrailingSlash('foo')).toBe('foo');
     expect(trimTrailingSlash('/foo/bar')).toBe('/foo/bar');

lib/util/url.ts

@@ -48,3 +48,11 @@ export function validateUrl(url?: string, httpOnly = true): boolean {
     return false;
   }
 }
+
+export function parseUrl(url: string): URL | null {
+  try {
+    return new URL(url);
+  } catch (err) {
+    return null;
+  }
+}