import type { Favicon } from "./types";
interface Options {
    timeout?: number;
}
/**
 * Extract all favicons from the given URL
 *
 * @example
 * ```ts
 * import { getFavicons } from "favicons";
 *
 * const favicons = await getFavicons("nextjs.com");
 * ```
 *
 * @param url
 * @param options
 * @returns Favicon[]
 */
export declare function getFavicons(url: string, options?: Options): Promise<Favicon[]>;
/**
 * Get the best favicon from the given URL
 *
 * @example
 * ```ts
 * import { getFavicon } from "favicons";
 *
 * const favicon = await getFavicon("nextjs.com");
 * ```
 *
 * @param url
 * @param options
 * @returns Favicon
 */
export declare function getFavicon(url: string, options: Options): Promise<Favicon>;
/**
 * Get the favicon urls from the given HTML (or head element)
 *
 * @example
 * ```ts
 * import { extractFavicons } from "favicons";
 *
 * const request = await fetch("https://nextjs.com");
 * const html = await request.text();
 * const favicons = extractFavicons(html);
 * ```
 *
 * @param html - html string of a website or head element specifically (faster)
 * @returns string[] - array of favicon urls
 */
export declare function extractFavicons(html: string): string[];
export type { Favicon } from "./types";