feat: added isUrlString()

Author: webdeveric

src/predicate/index.ts

@@ -56,3 +56,4 @@ export * from './isSymbolArray.js';
 export * from './isUndefined.js';
 export * from './isUndefinedArray.js';
 export * from './isUnknown.js';
+export * from './isUrlString.js';

src/predicate/isUrlString.ts

@@ -0,0 +1,3 @@
+export const isUrlString = (input: unknown): input is string => {
+  return typeof input === 'string' && URL.canParse(input);
+};

test/predicate/isUrlString.test.ts

@@ -0,0 +1,13 @@
+import { describe, it, expect } from 'vitest';
+
+import { isUrlString } from '../../src/predicate/isUrlString.js';
+
+describe('isUrlString()', () => {
+  it.each(['http://example.com', 'https://example.com'])('Returns true for valid input: %j', (input) => {
+    expect(isUrlString(input)).toBeTruthy();
+  });
+
+  it.each([1, 'a', true, null, {}, undefined])('Returns false for invalid input: %j', (input) => {
+    expect(isUrlString(input)).toBeFalsy();
+  });
+});