Installation

npm install --save @types/data-urls

Summary

This package contains type definitions for data-urls (https://github.com/jsdom/data-urls#readme).

Details

Files were exported from https://github.com/DefinitelyTyped/DefinitelyTyped/tree/master/types/data-urls.

index.d.ts

1import MIMEType = require("whatwg-mimetype");
2import { URLRecord } from "whatwg-url";
3
4/**
5 * Parses `data:` URLs.
6 *
7 * @param stringInput The `data:` URL to parse.
8 * @returns The parsed data URL, or `null` if the result cannot be parsed as a `data:` URL.
9 *
10 * @example
11 * import parseDataURL = require("data-urls");
12 *
13 * const textExample = parseDataURL("data:,Hello%2C%20World!");
14 * console.log(textExample.mimeType.toString()); // "text/plain;charset=US-ASCII"
15 * console.log(textExample.body);                // Uint8Array(13) [ 72, 101, 108, 108, 111, 44, … ]
16 *
17 * const htmlExample = parseDataURL("data:text/html,%3Ch1%3EHello%2C%20World!%3C%2Fh1%3E");
18 * console.log(htmlExample.mimeType.toString()); // "text/html"
19 * console.log(htmlExample.body);                // Uint8Array(22) [ 60, 104, 49, 62, 72, 101, … ]
20 *
21 * const pngExample = parseDataURL("data:image/png;base64,iVBORw0KGgoAAA" +
22 *                                 "ANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4" +
23 *                                 "//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU" +
24 *                                 "5ErkJggg==");
25 * console.log(pngExample.mimeType.toString()); // "image/png"
26 * console.log(pngExample.body);                // Uint8Array(85) [ 137, 80, 78, 71, 13, 10, … ]
27 */
28declare function parseDataURL(stringInput: string): parseDataURL.DataURL | null;
29
30declare namespace parseDataURL {
31    interface DataURL {
32        mimeType: MIMEType;
33        body: Uint8Array;
34    }
35
36    /**
37     * If you are using the [whatwg-url](https://github.com/jsdom/whatwg-url) package, you may already have a
38     * "URL record" object on hand, as produced by that package's `parseURL` export. In that case, you can use
39     * this function to save a bit of work.
40     *
41     * @example
42     * import { parseURL } from "whatwg-url";
43     * const dataURLFromURLRecord = require("data-urls").fromURLRecord;
44     *
45     * const urlRecord = parseURL("data:,Hello%2C%20World!");
46     * const dataURL = dataURLFromURLRecord(urlRecord);
47     */
48    function fromURLRecord(urlRecord: URLRecord): DataURL | null;
49}
50
51export = parseDataURL;
52

Additional Details

• Last updated: Mon, 06 Nov 2023 22:41:05 GMT
• Dependencies: @types/whatwg-mimetype, @types/whatwg-url

Credits

These definitions were written by Jaime Filho, and BendingBender.