Installation

npm install --save @types/valid-url

Summary

This package contains type definitions for valid-url (https://github.com/ogt/valid-url).

Details

Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/valid-url.

index.d.ts

1/**
2 * Is the value a well-formed uri?
3 * Returns the untainted URI if the test value appears to be well-formed.  Note that you may really want one of the more practical methods like is_http_uri or is_https_uri, since the URI standard (RFC 3986) allows a lot of things you probably don't want.
4 * @param value - The potential URI to test.
5 * @returns The untainted RFC 3986 URI on success, undefined on failure.
6 */
7export function isUri(value: string): string | undefined;
8
9/**
10 * Is the value a well-formed HTTP uri?
11 * Specialized version of isUri() that only likes http:// urls.  As a result, it can also do a much more thorough job validating.  Also, unlike isUri() it is more concerned with only allowing real-world URIs through.  Things like relative hostnames are allowed by the standards, but probably aren't wise.  Conversely, null paths aren't allowed per RFC 2616 (should be '/' instead), but are allowed by this function.
12 *
13 * This function only works for fully-qualified URIs.  /bob.html won't work. See RFC 3986 for the appropriate method to turn a relative URI into an absolute one given its context.
14 *
15 * Note that you probably want to either call this in combo with is_https_uri().
16 * i.e. if(isHttpUri(uri) || isHttpsUri(uri)) console.log('Good');
17 * or use the convenience method isWebUri which is equivalent.
18 * @param value - The potential URI to test.
19 * @returns The untainted RFC 3986 URI on success, undefined on failure.
20 */
21export function isHttpUri(value: string): string | undefined;
22
23/**
24 * Is the value a well-formed HTTPS uri?
25 * See is_http_uri() for details.  This version only likes the https URI scheme. Otherwise it's identical to is_http_uri().
26 * @param value - The potential URI to test.
27 * @returns The untainted RFC 3986 URI on success, undefined on failure.
28 */
29export function isHttpsUri(value: string): string | undefined;
30
31/**
32 * Is the value a well-formed HTTP or HTTPS uri?
33 * This is just a convenience method that combines isHttpUri and isHttpsUri to accept most common real-world URLs.
34 * @param value - The potential URI to test.
35 * @returns The untainted RFC 3986 URI on success, undefined on failure.
36 */
37export function isWebUri(value: string): string | undefined;
38

Additional Details

• Last updated: Tue, 07 Nov 2023 15:11:36 GMT
• Dependencies: none

Credits

These definitions were written by Gabriel Cangussu.