mirror of
https://gitlab.com/octtspacc/sitoctt
synced 2025-06-05 22:09:20 +02:00
.
This commit is contained in:
7
node_modules/data-urls/LICENSE.txt
generated
vendored
Normal file
7
node_modules/data-urls/LICENSE.txt
generated
vendored
Normal 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
62
node_modules/data-urls/README.md
generated
vendored
Normal 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
69
node_modules/data-urls/lib/parser.js
generated
vendored
Normal 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
18
node_modules/data-urls/lib/utils.js
generated
vendored
Normal 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
54
node_modules/data-urls/package.json
generated
vendored
Normal 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))"
|
||||
]
|
||||
}
|
||||
}
|
Reference in New Issue
Block a user