This commit is contained in:
2024-08-31 00:22:11 +02:00
commit eefa5f22b9
1206 changed files with 248159 additions and 0 deletions

7
node_modules/data-urls/LICENSE.txt generated vendored Normal file
View File

@ -0,0 +1,7 @@
Copyright © Domenic Denicola <d@domenic.me>
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

62
node_modules/data-urls/README.md generated vendored Normal file
View File

@ -0,0 +1,62 @@
# Parse `data:` URLs
This package helps you parse `data:` URLs [according to the WHATWG Fetch Standard](https://fetch.spec.whatwg.org/#data-urls):
```js
const parseDataURL = require("data-urls");
const textExample = parseDataURL("data:,Hello%2C%20World!");
console.log(textExample.mimeType.toString()); // "text/plain;charset=US-ASCII"
console.log(textExample.body); // Uint8Array(13) [ 72, 101, 108, 108, 111, 44, … ]
const htmlExample = parseDataURL("data:text/html,%3Ch1%3EHello%2C%20World!%3C%2Fh1%3E");
console.log(htmlExample.mimeType.toString()); // "text/html"
console.log(htmlExample.body); // Uint8Array(22) [ 60, 104, 49, 62, 72, 101, … ]
const pngExample = parseDataURL("data:image/png;base64,iVBORw0KGgoAAA" +
"ANSUhEUgAAAAUAAAAFCAYAAACNbyblAAAAHElEQVQI12P4" +
"//8/w38GIAXDIBKE0DHxgljNBAAO9TXL0Y4OHwAAAABJRU" +
"5ErkJggg==");
console.log(pngExample.mimeType.toString()); // "image/png"
console.log(pngExample.body); // Uint8Array(85) [ 137, 80, 78, 71, 13, 10, … ]
```
## API
This package's main module's default export is a function that accepts a string and returns a `{ mimeType, body }` object, or `null` if the result cannot be parsed as a `data:` URL.
- The `mimeType` property is an instance of [whatwg-mimetype](https://www.npmjs.com/package/whatwg-mimetype)'s `MIMEType` class.
- The `body` property is a `Uint8Array` instance.
As shown in the examples above, you can easily get a stringified version of the MIME type using its `toString()` method. Read on for more on getting the stringified version of the body.
### Decoding the body
To decode the body bytes of a parsed data URL, you'll need to use the `charset` parameter of the MIME type, if any. This contains an encoding [label](https://encoding.spec.whatwg.org/#label); there are [various possible labels](https://encoding.spec.whatwg.org/#names-and-labels) for a given encoding. We suggest using the [whatwg-encoding](https://www.npmjs.com/package/whatwg-encoding) package as follows:
```js
const parseDataURL = require("data-urls");
const { labelToName, decode } = require("whatwg-encoding");
const dataURL = parseDataURL(arbitraryString);
// If there's no charset parameter, let's just hope it's UTF-8; that seems like a good guess.
const encodingName = labelToName(dataURL.mimeType.parameters.get("charset") || "utf-8");
const bodyDecoded = decode(dataURL.body, encodingName);
```
This is especially important since the default, if no parseable MIME type is given, is "US-ASCII", [aka windows-1252](https://encoding.spec.whatwg.org/#names-and-labels), not UTF-8 like you might asume. So for example given an `arbitraryString` of `"data:,Héllo!"`, the above code snippet will correctly produce a `bodyDecoded` of `"Héllo!"` by using the windows-1252 decoder, whereas if you used a UTF-8 decoder you'd get back `"Héllo!"`.
### Advanced functionality: parsing from a URL record
If you are using the [whatwg-url](https://github.com/jsdom/whatwg-url) package, you may already have a "URL record" object on hand, as produced by that package's `parseURL` export. In that case, you can use this package's `fromURLRecord` export to save a bit of work:
```js
const { parseURL } = require("whatwg-url");
const dataURLFromURLRecord = require("data-urls").fromURLRecord;
const urlRecord = parseURL("data:,Hello%2C%20World!");
const dataURL = dataURLFromURLRecord(urlRecord);
```
In practice, we expect this functionality only to be used by consumers like [jsdom](https://www.npmjs.com/package/jsdom), which are using these packages at a very low level.

69
node_modules/data-urls/lib/parser.js generated vendored Normal file
View File

@ -0,0 +1,69 @@
"use strict";
const MIMEType = require("whatwg-mimetype");
const { parseURL, serializeURL, percentDecodeString } = require("whatwg-url");
const { stripLeadingAndTrailingASCIIWhitespace, isomorphicDecode, forgivingBase64Decode } = require("./utils.js");
module.exports = stringInput => {
const urlRecord = parseURL(stringInput);
if (urlRecord === null) {
return null;
}
return module.exports.fromURLRecord(urlRecord);
};
module.exports.fromURLRecord = urlRecord => {
if (urlRecord.scheme !== "data") {
return null;
}
const input = serializeURL(urlRecord, true).substring("data:".length);
let position = 0;
let mimeType = "";
while (position < input.length && input[position] !== ",") {
mimeType += input[position];
++position;
}
mimeType = stripLeadingAndTrailingASCIIWhitespace(mimeType);
if (position === input.length) {
return null;
}
++position;
const encodedBody = input.substring(position);
let body = percentDecodeString(encodedBody);
// Can't use /i regexp flag because it isn't restricted to ASCII.
const mimeTypeBase64MatchResult = /(.*); *[Bb][Aa][Ss][Ee]64$/u.exec(mimeType);
if (mimeTypeBase64MatchResult) {
const stringBody = isomorphicDecode(body);
body = forgivingBase64Decode(stringBody);
if (body === null) {
return null;
}
mimeType = mimeTypeBase64MatchResult[1];
}
if (mimeType.startsWith(";")) {
mimeType = `text/plain${mimeType}`;
}
let mimeTypeRecord;
try {
mimeTypeRecord = new MIMEType(mimeType);
} catch (e) {
mimeTypeRecord = new MIMEType("text/plain;charset=US-ASCII");
}
return {
mimeType: mimeTypeRecord,
body
};
};

18
node_modules/data-urls/lib/utils.js generated vendored Normal file
View File

@ -0,0 +1,18 @@
"use strict";
const { atob } = require("abab");
exports.stripLeadingAndTrailingASCIIWhitespace = string => {
return string.replace(/^[ \t\n\f\r]+/u, "").replace(/[ \t\n\f\r]+$/u, "");
};
exports.isomorphicDecode = input => {
return Array.from(input, byte => String.fromCodePoint(byte)).join("");
};
exports.forgivingBase64Decode = data => {
const asString = atob(data);
if (asString === null) {
return null;
}
return Uint8Array.from(asString, c => c.codePointAt(0));
};

54
node_modules/data-urls/package.json generated vendored Normal file
View File

@ -0,0 +1,54 @@
{
"name": "data-urls",
"description": "Parses data: URLs",
"keywords": [
"data url",
"data uri",
"data:",
"http",
"fetch",
"whatwg"
],
"version": "3.0.2",
"author": "Domenic Denicola <d@domenic.me> (https://domenic.me/)",
"license": "MIT",
"repository": "jsdom/data-urls",
"main": "lib/parser.js",
"files": [
"lib/"
],
"scripts": {
"test": "jest",
"coverage": "jest --coverage",
"lint": "eslint .",
"pretest": "node scripts/get-latest-platform-tests.js"
},
"dependencies": {
"abab": "^2.0.6",
"whatwg-mimetype": "^3.0.0",
"whatwg-url": "^11.0.0"
},
"devDependencies": {
"@domenic/eslint-config": "^2.0.0",
"eslint": "^8.14.0",
"jest": "^27.5.1",
"minipass-fetch": "^2.1.0"
},
"engines": {
"node": ">=12"
},
"jest": {
"coverageDirectory": "coverage",
"coverageReporters": [
"lcov",
"text-summary"
],
"testEnvironment": "node",
"testMatch": [
"<rootDir>/test/**/*.js"
],
"coveragePathIgnorePatterns": [
"<rootDir>/node_modules/(?!(abab/lib/atob.js))"
]
}
}