New methods: isURL/isURLObject

readme.md

@@ -945,6 +945,29 @@ isUndefined ( undefined ); // => true
 isUndefined ( null ); // => false
 ```
 
+#### `isURL` 🆕
+
+Checks if a value is a valid URL.
+
+```ts
+import {isURL} from 'is';
+
+isURL ( 'https://github.com/fabiospampinato/is' ); // => true
+isURL ( new URL ( 'https://github.com/fabiospampinato/is' ) ); // => true
+isURL ( 'invalid' ); // => false
+```
+
+#### `isURLObject` 🆕
+
+Checks if a value is a URL object.
+
+```ts
+import {isURLObject} from 'is';
+
+isURLObject ( new URL ( 'https://github.com/fabiospampinato/is' ) ); // => true
+isURLObject ( 'https://github.com/fabiospampinato/is' ); // => false
+```
+
 #### `isWeakMap`
 
 Checks if a value is a WeakMap.

src/index.ts

@@ -81,6 +81,8 @@ import isUint32Array from './is_uint32array';
 import isUint8Array from './is_uint8array';
 import isUint8ClampedArray from './is_uint8clampedarray';
 import isUndefined from './is_undefined';
+import isURL from './is_url';
+import isURLObject from './is_object'
 import isWeakMap from './is_weak_map';
 import isWeakRef from './is_weak_ref';
 import isWeakReferable from './is_weak_referable';
@@ -170,6 +172,8 @@ export {
   isUint8Array,
   isUint8ClampedArray,
   isUndefined,
+  isURL,
+  isURLObject,
   isWeakMap,
   isWeakRef,
   isWeakReferable,

src/is_url.ts

@@ -0,0 +1,12 @@
+
+/* MAIN */
+
+const isURL = ( value: unknown ): value is string | URL => {
+
+  return URL.canParse ( String ( value ) );
+
+};
+
+/* EXPORT */
+
+export default isURL;

src/is_url_object.ts

@@ -0,0 +1,12 @@
+
+/* MAIN */
+
+const isURLObject = ( value: unknown ): value is URL => {
+
+  return value?.constructor === URL;
+
+};
+
+/* EXPORT */
+
+export default isURLObject;

test/_utils.js

@@ -95,6 +95,7 @@ const realm = vm.runInNewContext ( /* javascript */`
       'string': 'a',
       'symbol': Symbol (),
       'undefined': undefined,
+      'url': 'https://github.com/fabiospampinato/is',
       'weakMap': new WeakMap (),
       'weakRef': new WeakRef ( WeakRef ),
       'weakSet': new WeakSet ()

test/is_url.js

@@ -0,0 +1,48 @@
+
+/* IMPORT */
+
+import {describe} from 'fava';
+import {isURL} from '../dist/index.js';
+import {realm} from './_utils.js';
+
+/* MAIN */
+
+describe ( 'isURL', test => {
+
+  test ( 'should return "true" for a valid URL string or URL object', t => {
+
+    const url = 'https://github.com/fabiospampinato/is';
+    const blob = new Blob ( [ url ], { type: 'text/plain' } );
+
+    t.true ( isURL ( url ) );
+    t.true ( isURL ( new URL ( url ) ) );
+    t.true ( isURL ( URL.createObjectURL ( blob ) ) );
+    t.true ( isURL ( 'http://www.github.com/fabiospampinato/is/' ) );
+
+  });
+
+  test ( 'should return "false" for everything else', t => {
+
+    t.false ( isURL ( 'invalid' ) );
+    t.false ( isURL ( 'www.github.com' ) );
+    t.false ( isURL ( 'github.com/' ) );
+    t.false ( isURL ( '' ) );
+    t.false ( isURL () );
+    t.false ( isURL ( true ) );
+    t.false ( isURL ( false ) );
+    t.false ( isURL ( 0 ) );
+    t.false ( isURL ( null ) );
+    t.false ( isURL ( undefined ) );
+    t.false ( isURL ( NaN ) );
+    t.false ( isURL ( [] ) );
+    t.false ( isURL ( {} ) );
+
+  });
+
+  test ( 'should work with a URL from another realm', t => {
+
+    t.true ( isURL ( realm.url ) );
+
+  });
+
+});

test/is_url_object.js

@@ -0,0 +1,39 @@
+
+/* IMPORT */
+
+import {describe} from 'fava';
+import {isURLObject} from '../dist/index.js';
+
+/* MAIN */
+
+describe ( 'isURLObject', test => {
+
+  const url = 'https://github.com/fabiospampinato/is';
+  const blob = new Blob ( [ url ], { type: 'text/plain' } );
+
+  test ( 'should return "true" for a URL object', t => {
+
+    t.true ( isURLObject ( new URL ( url ) ) );
+
+  });
+
+  test ( 'should return "false" for everything else', t => {
+
+    t.false ( isURLObject ( url ) );
+    t.false ( isURLObject ( URL.createObjectURL ( blob ) ) );
+    t.false ( isURLObject ( 'http://www.github.com/fabiospampinato/is/' ) );
+    t.false ( isURLObject ( 'invalid' ) );
+    t.false ( isURLObject ( 'www.github.com' ) );
+    t.false ( isURLObject ( 'github.com/' ) );
+    t.false ( isURLObject ( '' ) );
+    t.false ( isURLObject () );
+    t.false ( isURLObject ( true ) );
+    t.false ( isURLObject ( false ) );
+    t.false ( isURLObject ( 0 ) );
+    t.false ( isURLObject ( null ) );
+    t.false ( isURLObject ( undefined ) );
+    t.false ( isURLObject ( NaN ) );
+
+  });
+
+});