CyberChef/src/core/Utils.mjs

1409 lines
45 KiB
JavaScript
Raw Normal View History

2018-03-27 00:14:23 +02:00
/**
* @author n1474335 [n1474335@gmail.com]
* @copyright Crown Copyright 2016
* @license Apache-2.0
*/
import utf8 from "utf8";
import {fromBase64, toBase64} from "./lib/Base64.mjs";
import {fromHex} from "./lib/Hex.mjs";
import {fromDecimal} from "./lib/Decimal.mjs";
import {fromBinary} from "./lib/Binary.mjs";
2016-11-28 11:42:58 +01:00
/**
* Utility functions for use in operations, the core framework and the stage.
*/
2018-03-27 00:14:23 +02:00
class Utils {
2016-11-28 11:42:58 +01:00
/**
* Translates an ordinal into a character.
*
* @param {number} o
* @returns {char}
*
* @example
* // returns 'a'
* Utils.chr(97);
*/
2018-03-27 00:14:23 +02:00
static chr(o) {
// Detect astral symbols
// Thanks to @mathiasbynens for this solution
// https://mathiasbynens.be/notes/javascript-unicode
if (o > 0xffff) {
o -= 0x10000;
const high = String.fromCharCode(o >>> 10 & 0x3ff | 0xd800);
o = 0xdc00 | o & 0x3ff;
return high + String.fromCharCode(o);
}
2016-11-28 11:42:58 +01:00
return String.fromCharCode(o);
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Translates a character into an ordinal.
*
* @param {char} c
* @returns {number}
*
* @example
* // returns 97
* Utils.ord('a');
*/
2018-03-27 00:14:23 +02:00
static ord(c) {
// Detect astral symbols
// Thanks to @mathiasbynens for this solution
// https://mathiasbynens.be/notes/javascript-unicode
if (c.length === 2) {
const high = c.charCodeAt(0);
const low = c.charCodeAt(1);
if (high >= 0xd800 && high < 0xdc00 &&
low >= 0xdc00 && low < 0xe000) {
return (high - 0xd800) * 0x400 + low - 0xdc00 + 0x10000;
}
}
2016-11-28 11:42:58 +01:00
return c.charCodeAt(0);
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Adds trailing bytes to a byteArray.
*
* @author tlwr [toby@toby.codes]
*
* @param {byteArray} arr - byteArray to add trailing bytes to.
* @param {number} numBytes - Maximum width of the array.
* @param {Integer} [padByte=0] - The byte to pad with.
* @returns {byteArray}
*
* @example
* // returns ["a", 0, 0, 0]
* Utils.padBytesRight("a", 4);
*
* // returns ["a", 1, 1, 1]
* Utils.padBytesRight("a", 4, 1);
*
* // returns ["t", "e", "s", "t", 0, 0, 0, 0]
* Utils.padBytesRight("test", 8);
*
* // returns ["t", "e", "s", "t", 1, 1, 1, 1]
* Utils.padBytesRight("test", 8, 1);
*/
2018-03-27 00:14:23 +02:00
static padBytesRight(arr, numBytes, padByte=0) {
2017-04-13 19:08:50 +02:00
const paddedBytes = new Array(numBytes);
paddedBytes.fill(padByte);
[...arr].forEach((b, i) => {
paddedBytes[i] = b;
});
return paddedBytes;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Truncates a long string to max length and adds suffix.
*
* @param {string} str - String to truncate
* @param {number} max - Maximum length of the final string
* @param {string} [suffix='...'] - The string to add to the end of the final string
* @returns {string}
*
* @example
* // returns "A long..."
* Utils.truncate("A long string", 9);
*
* // returns "A long s-"
* Utils.truncate("A long string", 9, "-");
*/
2018-03-27 00:14:23 +02:00
static truncate(str, max, suffix="...") {
2016-11-28 11:42:58 +01:00
if (str.length > max) {
str = str.slice(0, max - suffix.length) + suffix;
}
return str;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Converts a character or number to its hex representation.
*
* @param {char|number} c
* @param {number} [length=2] - The width of the resulting hex number.
* @returns {string}
*
* @example
* // returns "6e"
* Utils.hex("n");
*
* // returns "6e"
* Utils.hex(110);
*/
2018-03-27 00:14:23 +02:00
static hex(c, length=2) {
2016-11-28 11:42:58 +01:00
c = typeof c == "string" ? Utils.ord(c) : c;
return c.toString(16).padStart(length, "0");
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Converts a character or number to its binary representation.
*
* @param {char|number} c
* @param {number} [length=8] - The width of the resulting binary number.
* @returns {string}
*
* @example
* // returns "01101110"
* Utils.bin("n");
*
* // returns "01101110"
* Utils.bin(110);
*/
2018-03-27 00:14:23 +02:00
static bin(c, length=8) {
2016-11-28 11:42:58 +01:00
c = typeof c == "string" ? Utils.ord(c) : c;
return c.toString(2).padStart(length, "0");
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Returns a string with all non-printable chars as dots, optionally preserving whitespace.
*
* @param {string} str - The input string to display.
* @param {boolean} [preserveWs=false] - Whether or not to print whitespace.
2016-11-28 11:42:58 +01:00
* @returns {string}
*/
2018-03-27 00:14:23 +02:00
static printable(str, preserveWs=false) {
if (isWebEnvironment() && window.app && !window.app.options.treatAsUtf8) {
str = Utils.byteArrayToChars(Utils.strToByteArray(str));
2016-11-28 11:42:58 +01:00
}
2019-07-05 13:22:52 +02:00
// eslint-disable-next-line no-misleading-character-class
const re = /[\0-\x08\x0B-\x0C\x0E-\x1F\x7F-\x9F\xAD\u0378\u0379\u037F-\u0383\u038B\u038D\u03A2\u0528-\u0530\u0557\u0558\u0560\u0588\u058B-\u058E\u0590\u05C8-\u05CF\u05EB-\u05EF\u05F5-\u0605\u061C\u061D\u06DD\u070E\u070F\u074B\u074C\u07B2-\u07BF\u07FB-\u07FF\u082E\u082F\u083F\u085C\u085D\u085F-\u089F\u08A1\u08AD-\u08E3\u08FF\u0978\u0980\u0984\u098D\u098E\u0991\u0992\u09A9\u09B1\u09B3-\u09B5\u09BA\u09BB\u09C5\u09C6\u09C9\u09CA\u09CF-\u09D6\u09D8-\u09DB\u09DE\u09E4\u09E5\u09FC-\u0A00\u0A04\u0A0B-\u0A0E\u0A11\u0A12\u0A29\u0A31\u0A34\u0A37\u0A3A\u0A3B\u0A3D\u0A43-\u0A46\u0A49\u0A4A\u0A4E-\u0A50\u0A52-\u0A58\u0A5D\u0A5F-\u0A65\u0A76-\u0A80\u0A84\u0A8E\u0A92\u0AA9\u0AB1\u0AB4\u0ABA\u0ABB\u0AC6\u0ACA\u0ACE\u0ACF\u0AD1-\u0ADF\u0AE4\u0AE5\u0AF2-\u0B00\u0B04\u0B0D\u0B0E\u0B11\u0B12\u0B29\u0B31\u0B34\u0B3A\u0B3B\u0B45\u0B46\u0B49\u0B4A\u0B4E-\u0B55\u0B58-\u0B5B\u0B5E\u0B64\u0B65\u0B78-\u0B81\u0B84\u0B8B-\u0B8D\u0B91\u0B96-\u0B98\u0B9B\u0B9D\u0BA0-\u0BA2\u0BA5-\u0BA7\u0BAB-\u0BAD\u0BBA-\u0BBD\u0BC3-\u0BC5\u0BC9\u0BCE\u0BCF\u0BD1-\u0BD6\u0BD8-\u0BE5\u0BFB-\u0C00\u0C04\u0C0D\u0C11\u0C29\u0C34\u0C3A-\u0C3C\u0C45\u0C49\u0C4E-\u0C54\u0C57\u0C5A-\u0C5F\u0C64\u0C65\u0C70-\u0C77\u0C80\u0C81\u0C84\u0C8D\u0C91\u0CA9\u0CB4\u0CBA\u0CBB\u0CC5\u0CC9\u0CCE-\u0CD4\u0CD7-\u0CDD\u0CDF\u0CE4\u0CE5\u0CF0\u0CF3-\u0D01\u0D04\u0D0D\u0D11\u0D3B\u0D3C\u0D45\u0D49\u0D4F-\u0D56\u0D58-\u0D5F\u0D64\u0D65\u0D76-\u0D78\u0D80\u0D81\u0D84\u0D97-\u0D99\u0DB2\u0DBC\u0DBE\u0DBF\u0DC7-\u0DC9\u0DCB-\u0DCE\u0DD5\u0DD7\u0DE0-\u0DF1\u0DF5-\u0E00\u0E3B-\u0E3E\u0E5C-\u0E80\u0E83\u0E85\u0E86\u0E89\u0E8B\u0E8C\u0E8E-\u0E93\u0E98\u0EA0\u0EA4\u0EA6\u0EA8\u0EA9\u0EAC\u0EBA\u0EBE\u0EBF\u0EC5\u0EC7\u0ECE\u0ECF\u0EDA\u0EDB\u0EE0-\u0EFF\u0F48\u0F6D-\u0F70\u0F98\u0FBD\u0FCD\u0FDB-\u0FFF\u10C6\u10C8-\u10CC\u10CE\u10CF\u1249\u124E\u124F\u1257\u1259\u125E\u125F\u1289\u128E\u128F\u12B1\u12B6\u12B7\u12BF\u12C1\u12C6\u12C7\u12D7\u1311\u1316\u1317\u135B\u135C\u137D-\u137F\u139A-\u139F\u13F5-\u13FF\u169D-\u169F\u16F1-\u16FF\u170D\u1715-\u171F\u1737-\u173F\u1754-\u175F\u176D\u1771\u1774-\u177F\u17DE\u17DF\u17EA-\u17EF\u17FA-\u17FF\u180F\u181A-\u181F\u1878-\u187F\u18AB-\u18AF\u18F6-\u18FF\u191D-\u191F\u192C-\u192F\u193C-\u193F\u1941-\u1943\u196E\u196F\u1975-\u197F\u19AC-\u19AF\u19CA-\u19CF\u19DB-\u19DD\u1A1C\u1A1D\u1A5F\u1A7D\u1A7E\u1A8A-\u1A8F\u1A9A-\u1A9F\u1AAE-\u1AFF\u1B4C-\u1B4F\u1B7D-\u1B7F\u1BF4-\u1BFB\u1C38-\u1C3A\u1C4A-\u1C4C\u1C80-\u1CBF\u1CC8-\u1CCF\u1CF7-\u1CFF\u1DE7-\u1DFB\u1F16\u1F17\u1F1E\u1F1F\u1F46\u1F47\u1F4E\u1F4F\u1F58\u1F5A\u1F5C\u1F5E\u1F7E\u1F7F\u1FB5\u1FC5\u1FD4\u1FD5\u1FDC\u1FF0\u1FF1\u1FF5\u1FFF\u200B-\u200F\u202A-\u202E\u2060-\u206F\u2072\u2073\u208F\u209D-\u209F\u20BB-\u20CF\u20F1-\u20FF\u218A-\u218F\u23F4-\u23FF\u2427-\u243F\u244B-\u245F\u2700\u2B4D-\u2B4F\u2B5A-\u2BFF\u2C2F\u2C5F\u2CF4-\u2CF8\u2D26\u2D28-\u2D2C\u2D2E\u2D2F\u2D68-\u2D6E\u2D71-\u2D7E\u2D97-\u2D9F\u2DA7\u2DAF\u2DB7\u2DBF\u2DC7\u2DCF\u2DD7\u2DDF\u2E3C-\u2E7F\u2E9A\u2EF4-\u2EFF\u2FD6-\u2FEF\u2FFC-\u2FFF\u3040\u3097\u3098\u3100-\u3104\u312E-\u3130\u318F\u31BB-\u31BF\u31E4-\u31EF\u321F\u32FF\u4DB6-\u4DBF\u9FCD-\u9FFF\uA48D-\uA48F\uA4C7-\uA4CF\uA62C-\uA63F\uA698-\uA69E\uA6F8-\uA6FF\uA78F\uA794-\uA79F\uA7AB-\uA7F7\uA82C-\uA82F\uA83A-\uA83F\uA878-\uA87F\uA8C5-\uA8CD\uA8DA-\uA8DF\uA8FC-\uA8FF\uA954-\uA95E\uA97D-\uA97F\uA9CE\uA9DA-\uA9DD\uA9E0-\uA9FF\uAA37-\uAA3F\uAA4E\uAA4F\uAA5A\uAA5B\uAA7C-\uAA7F\uAAC3-\uAADA\uAAF7-\uAB00\uAB07\uAB08\uAB0F\uAB10\uAB17-\uAB1F\uAB27\uAB2F-\uABBF\uABEE\uABEF\uABFA-\uABFF\uD7A4-\uD7AF\uD7C7-\uD7CA\uD7FC-\uD7FF\uE000-\uF8FF\uFA6E\uFA6F\uFADA-\uFAFF\uFB07-\uFB12\uFB18-\uFB1C\uFB37\uFB3D\uFB3F\uFB42\uFB45\uFBC2-\uFBD2\uFD40-\uFD4F\uFD90\uFD91\uFDC8-\uFDEF\uFDFE\uFDFF\uFE1A-\uFE1F\uFE27-\uFE2F\uFE53\uFE67\uFE6C-\uFE6F\uFE75\uFEFD-\uFF00\uFFBF-\uFFC1\uFFC8\uFFC9\uFFD0\uFFD1\uFFD8\uFFD9\uFFDD-\uFFDF\uFFE7\uFFEF-\uFFFB\uFFFE\uFFFF]/g;
2017-04-13 19:08:50 +02:00
const wsRe = /[\x09-\x10\x0D\u2028\u2029]/g;
2016-11-28 11:42:58 +01:00
str = str.replace(re, ".");
if (!preserveWs) str = str.replace(wsRe, ".");
2016-11-28 11:42:58 +01:00
return str;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Parse a string entered by a user and replace escaped chars with the bytes they represent.
*
* @param {string} str
* @returns {string}
*
* @example
* // returns "\x00"
* Utils.parseEscapedChars("\\x00");
2016-11-28 11:42:58 +01:00
*
* // returns "\n"
* Utils.parseEscapedChars("\\n");
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static parseEscapedChars(str) {
return str.replace(/\\([bfnrtv'"]|[0-3][0-7]{2}|[0-7]{1,2}|x[\da-fA-F]{2}|u[\da-fA-F]{4}|u\{[\da-fA-F]{1,6}\}|\\)/g, function(m, a) {
switch (a[0]) {
case "\\":
return "\\";
case "0":
2019-06-26 03:35:25 +02:00
case "1":
case "2":
case "3":
case "4":
case "5":
case "6":
case "7":
return String.fromCharCode(parseInt(a, 8));
2016-11-28 11:42:58 +01:00
case "b":
return "\b";
case "t":
return "\t";
case "n":
return "\n";
case "v":
return "\v";
2016-11-28 11:42:58 +01:00
case "f":
return "\f";
case "r":
return "\r";
case '"':
return '"';
case "'":
return "'";
2016-11-28 11:42:58 +01:00
case "x":
return String.fromCharCode(parseInt(a.substr(1), 16));
case "u":
if (a[1] === "{")
return String.fromCodePoint(parseInt(a.slice(2, -1), 16));
else
return String.fromCharCode(parseInt(a.substr(1), 16));
2016-11-28 11:42:58 +01:00
}
});
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Escape a string containing regex control characters so that it can be safely
* used in a regex without causing unintended behaviours.
*
* @param {string} str
* @returns {string}
*
* @example
* // returns "\[example\]"
* Utils.escapeRegex("[example]");
*/
2018-03-27 00:14:23 +02:00
static escapeRegex(str) {
2017-07-24 15:49:16 +02:00
return str.replace(/([.*+?^=!:${}()|[\]/\\])/g, "\\$1");
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Expand an alphabet range string into a list of the characters in that range.
*
* @param {string} alphStr
2016-11-28 11:42:58 +01:00
* @returns {char[]}
*
* @example
* // returns ["0", "1", "2", "3", "4", "5", "6", "7", "8", "9"]
* Utils.expandAlphRange("0-9");
2016-11-28 11:42:58 +01:00
*
* // returns ["a", "b", "c", "d", "0", "1", "2", "3", "+", "/"]
* Utils.expandAlphRange("a-d0-3+/");
2016-11-28 11:42:58 +01:00
*
* // returns ["a", "b", "c", "d", "0", "-", "3"]
* Utils.expandAlphRange("a-d0\\-3")
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static expandAlphRange(alphStr) {
2017-04-13 19:08:50 +02:00
const alphArr = [];
2017-04-13 19:08:50 +02:00
for (let i = 0; i < alphStr.length; i++) {
if (i < alphStr.length - 2 &&
alphStr[i+1] === "-" &&
alphStr[i] !== "\\") {
const start = Utils.ord(alphStr[i]),
end = Utils.ord(alphStr[i+2]);
2017-04-13 19:08:50 +02:00
for (let j = start; j <= end; j++) {
alphArr.push(Utils.chr(j));
2016-11-28 11:42:58 +01:00
}
i += 2;
} else if (i < alphStr.length - 2 &&
alphStr[i] === "\\" &&
alphStr[i+1] === "-") {
alphArr.push("-");
2016-11-28 11:42:58 +01:00
i++;
} else {
alphArr.push(alphStr[i]);
2016-11-28 11:42:58 +01:00
}
}
return alphArr;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Coverts data of varying types to a byteArray.
* Accepts hex, Base64, UTF8 and Latin1 strings.
2018-01-02 15:46:35 +01:00
*
* @param {string} str
* @param {string} type - One of "Binary", "Hex", "Decimal", "Base64", "UTF8" or "Latin1"
* @returns {byteArray}
2018-01-02 15:46:35 +01:00
*
* @example
* // returns [208, 159, 209, 128, 208, 184, 208, 178, 208, 181, 209, 130]
* Utils.convertToByteArray("Привет", "utf8");
2018-01-02 15:46:35 +01:00
*
* // returns [208, 159, 209, 128, 208, 184, 208, 178, 208, 181, 209, 130]
* Utils.convertToByteArray("d097d0b4d180d0b0d0b2d181d182d0b2d183d0b9d182d0b5", "hex");
2018-01-02 15:46:35 +01:00
*
* // returns [208, 159, 209, 128, 208, 184, 208, 178, 208, 181, 209, 130]
* Utils.convertToByteArray("0JfQtNGA0LDQstGB0YLQstGD0LnRgtC1", "base64");
*/
2018-03-27 00:14:23 +02:00
static convertToByteArray(str, type) {
switch (type.toLowerCase()) {
case "binary":
return fromBinary(str);
case "hex":
return fromHex(str);
case "decimal":
return fromDecimal(str);
case "base64":
return fromBase64(str, null, "byteArray");
case "utf8":
return Utils.strToUtf8ByteArray(str);
case "latin1":
default:
return Utils.strToByteArray(str);
}
2018-03-27 00:14:23 +02:00
}
/**
* Coverts data of varying types to a byte string.
* Accepts hex, Base64, UTF8 and Latin1 strings.
2018-01-02 15:46:35 +01:00
*
* @param {string} str
* @param {string} type - One of "Binary", "Hex", "Decimal", "Base64", "UTF8" or "Latin1"
* @returns {string}
2018-01-02 15:46:35 +01:00
*
* @example
* // returns "Привет"
* Utils.convertToByteString("Привет", "utf8");
2018-01-02 15:46:35 +01:00
*
* // returns "Здравствуйте"
* Utils.convertToByteString("d097d0b4d180d0b0d0b2d181d182d0b2d183d0b9d182d0b5", "hex");
2018-01-02 15:46:35 +01:00
*
* // returns "Здравствуйте"
* Utils.convertToByteString("0JfQtNGA0LDQstGB0YLQstGD0LnRgtC1", "base64");
*/
2018-03-27 00:14:23 +02:00
static convertToByteString(str, type) {
switch (type.toLowerCase()) {
case "binary":
return Utils.byteArrayToChars(fromBinary(str));
case "hex":
return Utils.byteArrayToChars(fromHex(str));
case "decimal":
return Utils.byteArrayToChars(fromDecimal(str));
case "base64":
return Utils.byteArrayToChars(fromBase64(str, null, "byteArray"));
case "utf8":
return utf8.encode(str);
case "latin1":
default:
return str;
}
2018-03-27 00:14:23 +02:00
}
/**
* Converts a string to an ArrayBuffer.
* Treats the string as UTF-8 if any values are over 255.
*
* @param {string} str
* @returns {ArrayBuffer}
*
* @example
* // returns [72,101,108,108,111]
* Utils.strToArrayBuffer("Hello");
*
* // returns [228,189,160,229,165,189]
* Utils.strToArrayBuffer("你好");
*/
static strToArrayBuffer(str) {
const arr = new Uint8Array(str.length);
let i = str.length, b;
while (i--) {
b = str.charCodeAt(i);
arr[i] = b;
// If any of the bytes are over 255, read as UTF-8
if (b > 255) return Utils.strToUtf8ArrayBuffer(str);
}
return arr.buffer;
}
/**
* Converts a string to a UTF-8 ArrayBuffer.
*
* @param {string} str
* @returns {ArrayBuffer}
*
* @example
* // returns [72,101,108,108,111]
* Utils.strToUtf8ArrayBuffer("Hello");
*
* // returns [228,189,160,229,165,189]
* Utils.strToUtf8ArrayBuffer("你好");
*/
static strToUtf8ArrayBuffer(str) {
const utf8Str = utf8.encode(str);
if (str.length !== utf8Str.length) {
if (isWorkerEnvironment()) {
self.setOption("attemptHighlight", false);
} else if (isWebEnvironment()) {
window.app.options.attemptHighlight = false;
}
}
return Utils.strToArrayBuffer(utf8Str);
}
2016-11-28 11:42:58 +01:00
/**
* Converts a string to a byte array.
* Treats the string as UTF-8 if any values are over 255.
*
* @param {string} str
* @returns {byteArray}
2016-11-28 11:42:58 +01:00
*
* @example
* // returns [72,101,108,108,111]
* Utils.strToByteArray("Hello");
2016-11-28 11:42:58 +01:00
*
* // returns [228,189,160,229,165,189]
* Utils.strToByteArray("你好");
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static strToByteArray(str) {
2017-04-13 19:08:50 +02:00
const byteArray = new Array(str.length);
let i = str.length, b;
2016-11-28 11:42:58 +01:00
while (i--) {
b = str.charCodeAt(i);
byteArray[i] = b;
2016-11-28 11:42:58 +01:00
// If any of the bytes are over 255, read as UTF-8
if (b > 255) return Utils.strToUtf8ByteArray(str);
2016-11-28 11:42:58 +01:00
}
return byteArray;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Converts a string to a UTF-8 byte array.
*
* @param {string} str
* @returns {byteArray}
2016-11-28 11:42:58 +01:00
*
* @example
* // returns [72,101,108,108,111]
* Utils.strToUtf8ByteArray("Hello");
2016-11-28 11:42:58 +01:00
*
* // returns [228,189,160,229,165,189]
* Utils.strToUtf8ByteArray("你好");
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static strToUtf8ByteArray(str) {
const utf8Str = utf8.encode(str);
2016-11-28 11:42:58 +01:00
if (str.length !== utf8Str.length) {
if (isWorkerEnvironment()) {
self.setOption("attemptHighlight", false);
} else if (isWebEnvironment()) {
window.app.options.attemptHighlight = false;
}
2017-04-05 23:00:06 +02:00
}
return Utils.strToByteArray(utf8Str);
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Converts a string to a unicode charcode array
2016-11-28 11:42:58 +01:00
*
* @param {string} str
* @returns {byteArray}
2016-11-28 11:42:58 +01:00
*
* @example
* // returns [72,101,108,108,111]
* Utils.strToCharcode("Hello");
2016-11-28 11:42:58 +01:00
*
* // returns [20320,22909]
* Utils.strToCharcode("你好");
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static strToCharcode(str) {
2017-10-03 19:14:40 +02:00
const charcode = [];
for (let i = 0; i < str.length; i++) {
let ord = str.charCodeAt(i);
// Detect and merge astral symbols
if (i < str.length - 1 && ord >= 0xd800 && ord < 0xdc00) {
const low = str[i + 1].charCodeAt(0);
if (low >= 0xdc00 && low < 0xe000) {
ord = Utils.ord(str[i] + str[++i]);
}
}
charcode.push(ord);
2016-11-28 11:42:58 +01:00
}
return charcode;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Attempts to convert a byte array to a UTF-8 string.
*
* @param {byteArray|Uint8Array} byteArray
2016-11-28 11:42:58 +01:00
* @returns {string}
*
* @example
* // returns "Hello"
* Utils.byteArrayToUtf8([72,101,108,108,111]);
2016-11-28 11:42:58 +01:00
*
* // returns "你好"
* Utils.byteArrayToUtf8([228,189,160,229,165,189]);
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static byteArrayToUtf8(byteArray) {
const str = Utils.byteArrayToChars(byteArray);
2016-11-28 11:42:58 +01:00
try {
const utf8Str = utf8.decode(str);
if (str.length !== utf8Str.length) {
if (isWorkerEnvironment()) {
self.setOption("attemptHighlight", false);
} else if (isWebEnvironment()) {
window.app.options.attemptHighlight = false;
}
}
return utf8Str;
2016-11-28 11:42:58 +01:00
} catch (err) {
// If it fails, treat it as ANSI
return str;
2016-11-28 11:42:58 +01:00
}
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Converts a charcode array to a string.
*
* @param {byteArray|Uint8Array} byteArray
2016-11-28 11:42:58 +01:00
* @returns {string}
*
* @example
* // returns "Hello"
* Utils.byteArrayToChars([72,101,108,108,111]);
2016-11-28 11:42:58 +01:00
*
* // returns "你好"
* Utils.byteArrayToChars([20320,22909]);
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static byteArrayToChars(byteArray) {
if (!byteArray) return "";
2017-04-13 19:08:50 +02:00
let str = "";
// String concatenation appears to be faster than an array join
2017-04-13 19:08:50 +02:00
for (let i = 0; i < byteArray.length;) {
str += String.fromCharCode(byteArray[i++]);
2016-11-28 11:42:58 +01:00
}
return str;
2018-03-27 00:14:23 +02:00
}
/**
* Converts an ArrayBuffer to a string.
2018-01-02 15:46:35 +01:00
*
* @param {ArrayBuffer} arrayBuffer
* @param {boolean} [utf8=true] - Whether to attempt to decode the buffer as UTF-8
* @returns {string}
2018-01-02 15:46:35 +01:00
*
* @example
* // returns "hello"
* Utils.arrayBufferToStr(Uint8Array.from([104,101,108,108,111]).buffer);
*/
2018-03-27 00:14:23 +02:00
static arrayBufferToStr(arrayBuffer, utf8=true) {
const arr = new Uint8Array(arrayBuffer);
return utf8 ? Utils.byteArrayToUtf8(arr) : Utils.byteArrayToChars(arr);
2018-03-27 00:14:23 +02:00
}
/**
* Calculates the Shannon entropy for a given set of data.
*
* @param {Uint8Array|ArrayBuffer} input
* @returns {number}
*/
static calculateShannonEntropy(data) {
if (data instanceof ArrayBuffer) {
data = new Uint8Array(data);
}
const prob = [],
occurrences = new Array(256).fill(0);
// Count occurrences of each byte in the input
let i;
for (i = 0; i < data.length; i++) {
occurrences[data[i]]++;
}
// Store probability list
for (i = 0; i < occurrences.length; i++) {
if (occurrences[i] > 0) {
prob.push(occurrences[i] / data.length);
}
}
// Calculate Shannon entropy
let entropy = 0,
p;
for (i = 0; i < prob.length; i++) {
p = prob[i];
entropy += p * Math.log(p) / Math.log(2);
}
return -entropy;
}
2016-11-28 11:42:58 +01:00
/**
* Parses CSV data and returns it as a two dimensional array or strings.
*
* @param {string} data
* @param {string[]} [cellDelims=[","]]
* @param {string[]} [lineDelims=["\n", "\r"]]
2016-11-28 11:42:58 +01:00
* @returns {string[][]}
*
* @example
* // returns [["head1", "head2"], ["data1", "data2"]]
* Utils.parseCSV("head1,head2\ndata1,data2");
2016-11-28 11:42:58 +01:00
*/
2018-05-14 13:58:01 +02:00
static parseCSV(data, cellDelims=[","], lineDelims=["\n", "\r"]) {
2017-04-13 19:08:50 +02:00
let b,
next,
renderNext = false,
inString = false,
2016-11-28 11:42:58 +01:00
cell = "",
line = [];
const lines = [];
// Remove BOM, often present in Excel CSV files
if (data.length && data[0] === "\uFEFF") data = data.substr(1);
2017-04-13 19:08:50 +02:00
for (let i = 0; i < data.length; i++) {
2016-11-28 11:42:58 +01:00
b = data[i];
next = data[i+1] || "";
if (renderNext) {
2016-11-28 11:42:58 +01:00
cell += b;
renderNext = false;
} else if (b === "\"" && !inString) {
inString = true;
} else if (b === "\"" && inString) {
if (next === "\"") renderNext = true;
else inString = false;
} else if (!inString && cellDelims.indexOf(b) >= 0) {
2016-11-28 11:42:58 +01:00
line.push(cell);
cell = "";
} else if (!inString && lineDelims.indexOf(b) >= 0) {
2016-11-28 11:42:58 +01:00
line.push(cell);
cell = "";
lines.push(line);
line = [];
// Skip next byte if it is also a line delim (e.g. \r\n)
if (lineDelims.indexOf(next) >= 0 && next !== b) {
i++;
}
2016-11-28 11:42:58 +01:00
} else {
cell += b;
}
}
2016-11-28 11:42:58 +01:00
if (line.length) {
line.push(cell);
lines.push(line);
}
2016-11-28 11:42:58 +01:00
return lines;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Removes all HTML (or XML) tags from the input string.
*
* @param {string} htmlStr
2018-03-27 00:14:23 +02:00
* @param {boolean} [removeScriptAndStyle=false]
* - Flag to specify whether to remove entire script or style blocks
2016-11-28 11:42:58 +01:00
* @returns {string}
*
* @example
* // returns "Test"
* Utils.stripHtmlTags("<div>Test</div>");
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static stripHtmlTags(htmlStr, removeScriptAndStyle=false) {
if (removeScriptAndStyle) {
htmlStr = htmlStr.replace(/<(script|style)[^>]*>.*<\/(script|style)>/gmi, "");
2016-11-28 11:42:58 +01:00
}
return htmlStr.replace(/<[^>]+>/g, "");
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Escapes HTML tags in a string to stop them being rendered.
* https://www.owasp.org/index.php/XSS_(Cross_Site_Scripting)_Prevention_Cheat_Sheet
2016-11-28 11:42:58 +01:00
*
* @param {string} str
* @returns string
*
* @example
* // return "A &lt;script&gt; tag"
* Utils.escapeHtml("A <script> tag");
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static escapeHtml(str) {
2017-04-13 19:08:50 +02:00
const HTML_CHARS = {
"&": "&amp;",
"<": "&lt;",
">": "&gt;",
'"': "&quot;",
"'": "&#x27;", // &apos; not recommended because it's not in the HTML spec
"/": "&#x2F;", // forward slash is included as it helps end an HTML entity
"`": "&#x60;"
};
2017-07-24 15:49:16 +02:00
return str.replace(/[&<>"'/`]/g, function (match) {
return HTML_CHARS[match];
});
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
/**
* Unescapes HTML tags in a string to make them render again.
*
* @param {string} str
* @returns string
*
* @example
* // return "A <script> tag"
* Utils.unescapeHtml("A &lt;script&gt; tag");
*/
2018-03-27 00:14:23 +02:00
static unescapeHtml(str) {
2017-04-13 19:08:50 +02:00
const HTML_CHARS = {
"&amp;": "&",
"&lt;": "<",
"&gt;": ">",
"&quot;": '"',
"&#x27;": "'",
"&#x2F;": "/",
"&#x60;": "`"
};
return str.replace(/&#?x?[a-z0-9]{2,4};/ig, function (match) {
return HTML_CHARS[match] || match;
});
2018-03-27 00:14:23 +02:00
}
/**
* Encodes a URI fragment (#) or query (?) using a minimal amount of percent-encoding.
*
* RFC 3986 defines legal characters for the fragment and query parts of a URL to be as follows:
*
* fragment = *( pchar / "/" / "?" )
* query = *( pchar / "/" / "?" )
2017-12-20 16:51:57 +01:00
* pchar = unreserved / pct-encoded / sub-delims / ":" / "@"
* unreserved = ALPHA / DIGIT / "-" / "." / "_" / "~"
* pct-encoded = "%" HEXDIG HEXDIG
* sub-delims = "!" / "$" / "&" / "'" / "(" / ")"
* / "*" / "+" / "," / ";" / "="
*
* Meaning that the list of characters that need not be percent-encoded are alphanumeric plus:
* -._~!$&'()*+,;=:@/?
*
* & and = are still escaped as they are used to serialise the key-value pairs in CyberChef
* fragments. + is also escaped so as to prevent it being decoded to a space.
*
* @param {string} str
* @returns {string}
*/
2018-03-27 00:14:23 +02:00
static encodeURIFragment(str) {
const LEGAL_CHARS = {
"%2D": "-",
"%2E": ".",
"%5F": "_",
"%7E": "~",
"%21": "!",
"%24": "$",
2019-11-14 09:55:27 +01:00
// "%26": "&",
"%27": "'",
"%28": "(",
"%29": ")",
"%2A": "*",
2019-11-14 09:55:27 +01:00
// "%2B": "+",
"%2C": ",",
"%3B": ";",
2019-11-14 09:55:27 +01:00
// "%3D": "=",
"%3A": ":",
"%40": "@",
"%2F": "/",
"%3F": "?"
};
str = encodeURIComponent(str);
return str.replace(/%[0-9A-F]{2}/g, function (match) {
return LEGAL_CHARS[match] || match;
});
2018-03-27 00:14:23 +02:00
}
/**
* Generates a "pretty" recipe format from a recipeConfig object.
*
* "Pretty" CyberChef recipe formats are designed to be included in the fragment (#) or query (?)
* parts of the URL. They can also be loaded into CyberChef through the 'Load' interface. In order
* to make this format as readable as possible, various special characters are used unescaped. This
* reduces the amount of percent-encoding included in the URL which is typically difficult to read
* and substantially increases the overall length. These characteristics can be quite off-putting
* for users.
*
* @param {Object[]} recipeConfig
* @param {boolean} [newline=false] - whether to add a newline after each operation
* @returns {string}
*/
static generatePrettyRecipe(recipeConfig, newline = false) {
let prettyConfig = "",
name = "",
args = "",
disabled = "",
bp = "";
recipeConfig.forEach(op => {
name = op.op.replace(/ /g, "_");
args = JSON.stringify(op.args)
.slice(1, -1) // Remove [ and ] as they are implied
// We now need to switch double-quoted (") strings to single quotes (') as single quotes
// do not need to be percent-encoded.
.replace(/'/g, "\\'") // Escape single quotes
.replace(/"((?:[^"\\]|\\.)*)"/g, "'$1'") // Replace opening and closing " with '
.replace(/\\"/g, '"'); // Unescape double quotes
disabled = op.disabled ? "/disabled": "";
bp = op.breakpoint ? "/breakpoint" : "";
prettyConfig += `${name}(${args}${disabled}${bp})`;
if (newline) prettyConfig += "\n";
});
return prettyConfig;
2018-03-27 00:14:23 +02:00
}
/**
* Converts a recipe string to the JSON representation of the recipe.
2018-03-27 00:14:23 +02:00
* Accepts either stringified JSON or the bespoke "pretty" recipe format.
*
* @param {string} recipe
* @returns {Object[]}
*/
2018-03-27 00:14:23 +02:00
static parseRecipeConfig(recipe) {
recipe = recipe.trim();
if (recipe.length === 0) return [];
if (recipe[0] === "[") return JSON.parse(recipe);
// Parse bespoke recipe format
recipe = recipe.replace(/\n/g, "");
let m, args;
const recipeRegex = /([^(]+)\(((?:'[^'\\]*(?:\\.[^'\\]*)*'|[^)/'])*)(\/[^)]+)?\)/g,
recipeConfig = [];
while ((m = recipeRegex.exec(recipe))) {
// Translate strings in args back to double-quotes
args = m[2]
.replace(/"/g, '\\"') // Escape double quotes
.replace(/(^|,|{|:)'/g, '$1"') // Replace opening ' with "
.replace(/([^\\]|(?:\\\\)+)'(,|:|}|$)/g, '$1"$2') // Replace closing ' with "
.replace(/\\'/g, "'"); // Unescape single quotes
args = "[" + args + "]";
const op = {
op: m[1].replace(/_/g, " "),
args: JSON.parse(args)
};
if (m[3] && m[3].indexOf("disabled") > 0) op.disabled = true;
if (m[3] && m[3].indexOf("breakpoint") > 0) op.breakpoint = true;
recipeConfig.push(op);
}
return recipeConfig;
2018-03-27 00:14:23 +02:00
}
/**
* Formats a list of files or directories.
*
* @author tlwr [toby@toby.codes]
* @author n1474335 [n1474335@gmail.com]
*
* @param {File[]} files
* @returns {html}
*/
static async displayFilesAsHTML(files) {
2017-04-13 19:08:50 +02:00
const formatDirectory = function(file) {
2018-07-15 14:25:44 +02:00
const html = `<div class='card' style='white-space: normal;'>
<div class='card-header'>
<h6 class="mb-0">
${Utils.escapeHtml(file.name)}
2018-07-15 14:25:44 +02:00
</h6>
</div>
</div>`;
return html;
};
2018-12-21 16:57:09 +01:00
const formatContent = function (buff, type) {
if (type.startsWith("image")) {
let dataURI = "data:";
dataURI += type + ";";
dataURI += "base64," + toBase64(buff);
return "<img style='max-width: 100%;' src='" + dataURI + "'>";
2018-12-21 16:57:09 +01:00
} else {
return `<pre>${Utils.escapeHtml(Utils.arrayBufferToStr(buff.buffer))}</pre>`;
}
};
const formatFile = async function(file, i) {
const buff = await Utils.readFile(file);
2017-04-13 19:08:50 +02:00
const blob = new Blob(
[buff],
{type: file.type || "octet/stream"}
);
const blobURL = URL.createObjectURL(blob);
2018-07-15 14:25:44 +02:00
const html = `<div class='card' style='white-space: normal;'>
<div class='card-header' id='heading${i}'>
<h6 class='mb-0'>
<a class='collapsed'
data-toggle='collapse'
href='#collapse${i}'
aria-expanded='false'
aria-controls='collapse${i}'
title="Show/hide contents of '${Utils.escapeHtml(file.name)}'">
${Utils.escapeHtml(file.name)}</a>
<span class='float-right' style="margin-top: -3px">
${file.size.toLocaleString()} bytes
<a title="Download ${Utils.escapeHtml(file.name)}"
href="${blobURL}"
download="${Utils.escapeHtml(file.name)}"
data-toggle="tooltip">
2018-07-15 14:25:44 +02:00
<i class="material-icons" style="vertical-align: bottom">save</i>
</a>
<a title="Move to input"
href="#"
blob-url="${blobURL}"
file-name="${Utils.escapeHtml(file.name)}"
class="extract-file"
data-toggle="tooltip">
<i class="material-icons" style="vertical-align: bottom">open_in_browser</i>
</a>
2018-07-15 14:25:44 +02:00
</span>
</h6>
</div>
2018-07-15 14:25:44 +02:00
<div id='collapse${i}' class='collapse' aria-labelledby='heading${i}' data-parent="#files">
<div class='card-body'>
2018-12-21 16:57:09 +01:00
${formatContent(buff, file.type)}
</div>
</div>
</div>`;
return html;
};
let html = `<div style='padding: 5px; white-space: normal;'>
2018-07-15 14:25:44 +02:00
${files.length} file(s) found
</div><div id="files" style="padding: 20px">`;
for (let i = 0; i < files.length; i++) {
if (files[i].name.endsWith("/")) {
html += formatDirectory(files[i]);
} else {
html += await formatFile(files[i], i);
}
}
2018-07-15 14:25:44 +02:00
return html += "</div>";
2018-03-27 00:14:23 +02:00
}
/**
* Parses URI parameters into a JSON object.
*
* @param {string} paramStr - The serialised query or hash section of a URI
* @returns {object}
*
* @example
* // returns {a: 'abc', b: '123'}
* Utils.parseURIParams("?a=abc&b=123")
* Utils.parseURIParams("#a=abc&b=123")
*/
2018-03-27 00:14:23 +02:00
static parseURIParams(paramStr) {
if (paramStr === "") return {};
// Cut off ? or # and split on &
if (paramStr[0] === "?" ||
paramStr[0] === "#") {
paramStr = paramStr.substr(1);
}
const params = paramStr.split("&");
const result = {};
for (let i = 0; i < params.length; i++) {
const param = params[i].split("=");
if (param.length !== 2) {
result[params[i]] = true;
} else {
result[param[0]] = decodeURIComponent(param[1].replace(/\+/g, " "));
}
}
return result;
2018-03-27 00:14:23 +02:00
}
/**
* Reads a File and returns the data as a Uint8Array.
*
* @param {File | for node: array|arrayBuffer|buffer|string} file
* @returns {Uint8Array}
*
* @example
* // returns Uint8Array(5) [104, 101, 108, 108, 111]
* await Utils.readFile(new File(["hello"], "test"))
*/
static readFile(file) {
if (isNodeEnvironment()) {
return Buffer.from(file).buffer;
} else {
return new Promise((resolve, reject) => {
const reader = new FileReader();
const data = new Uint8Array(file.size);
let offset = 0;
const CHUNK_SIZE = 10485760; // 10MiB
const seek = function() {
if (offset >= file.size) {
resolve(data);
return;
}
const slice = file.slice(offset, offset + CHUNK_SIZE);
reader.readAsArrayBuffer(slice);
};
reader.onload = function(e) {
data.set(new Uint8Array(reader.result), offset);
offset += CHUNK_SIZE;
seek();
};
reader.onerror = function(e) {
reject(reader.error.message);
};
seek();
});
}
}
/**
2019-04-05 18:35:20 +02:00
* Synchronously read the raw data from a File object.
*
* Only works in the Node environment
*
* @param {File} file - a File shim object (see src/node/File.mjs)
* @returns {ArrayBuffer} the data from the file in an ArrayBuffer
* @throws {TypeError} thrown if the method is called from a browser environment
*/
static readFileSync(file) {
if (!isNodeEnvironment()) {
throw new TypeError("Browser environment cannot support readFileSync");
}
2019-04-29 18:09:01 +02:00
const arrayBuffer = Uint8Array.from(file.data);
return arrayBuffer.buffer;
}
/**
2017-02-09 15:17:44 +01:00
* Actual modulo function, since % is actually the remainder function in JS.
2017-02-08 18:29:50 +01:00
*
2017-06-22 18:13:31 +02:00
* @author Matt C [matt@artemisbot.uk]
* @param {number} x
* @param {number} y
2017-02-09 15:17:44 +01:00
* @returns {number}
*/
2018-03-27 00:14:23 +02:00
static mod(x, y) {
return ((x % y) + y) % y;
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
2017-02-08 18:29:50 +01:00
/**
2017-02-09 15:17:44 +01:00
* Finds the greatest common divisor of two numbers.
2017-02-08 18:29:50 +01:00
*
2017-06-22 18:13:31 +02:00
* @author Matt C [matt@artemisbot.uk]
* @param {number} x
* @param {number} y
2017-02-09 15:17:44 +01:00
* @returns {number}
*/
2018-03-27 00:14:23 +02:00
static gcd(x, y) {
if (!y) {
return x;
}
return Utils.gcd(y, x % y);
2018-03-27 00:14:23 +02:00
}
2017-02-08 18:29:50 +01:00
/**
2017-02-09 15:17:44 +01:00
* Finds the modular inverse of two values.
2017-02-08 18:29:50 +01:00
*
2017-06-22 18:13:31 +02:00
* @author Matt C [matt@artemisbot.uk]
2017-02-08 18:29:50 +01:00
* @param {number} x
* @param {number} y
2017-02-09 15:17:44 +01:00
* @returns {number}
2017-02-08 18:29:50 +01:00
*/
2018-03-27 00:14:23 +02:00
static modInv(x, y) {
x %= y;
2017-04-13 19:08:50 +02:00
for (let i = 1; i < y; i++) {
if ((x * i) % 26 === 1) {
return i;
}
}
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
2017-02-08 18:29:50 +01:00
2016-11-28 11:42:58 +01:00
/**
* A mapping of names of delimiter characters to their symbols.
2018-03-27 00:14:23 +02:00
*
* @param {string} token
* @returns {string}
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static charRep(token) {
return {
"Space": " ",
"Percent": "%",
2018-03-27 00:14:23 +02:00
"Comma": ",",
"Semi-colon": ";",
"Colon": ":",
"Tab": "\t",
2018-03-27 00:14:23 +02:00
"Line feed": "\n",
"CRLF": "\r\n",
"Forward slash": "/",
"Backslash": "\\",
"0x": "0x",
"\\x": "\\x",
"Nothing (separate chars)": "",
"None": "",
}[token];
}
2016-11-28 11:42:58 +01:00
/**
* A mapping of names of delimiter characters to regular expressions which can select them.
2018-03-27 00:14:23 +02:00
*
* @param {string} token
* @returns {RegExp}
2016-11-28 11:42:58 +01:00
*/
2018-03-27 00:14:23 +02:00
static regexRep(token) {
return {
"Space": /\s+/g,
"Percent": /%/g,
2018-03-27 00:14:23 +02:00
"Comma": /,/g,
"Semi-colon": /;/g,
"Colon": /:/g,
"Line feed": /\n/g,
"CRLF": /\r\n/g,
"Forward slash": /\//g,
"Backslash": /\\/g,
2020-03-10 12:12:43 +01:00
"0x with comma": /,?0x/g,
2018-03-27 00:14:23 +02:00
"0x": /0x/g,
"\\x": /\\x/g,
"None": /\s+/g // Included here to remove whitespace when there shouldn't be any
}[token];
}
2016-11-28 11:42:58 +01:00
}
/**
* Check whether the code is running in a Node.js environment
* @returns {boolean}
*/
export function isNodeEnvironment() {
return typeof process !== "undefined" && process.versions != null && process.versions.node != null;
}
/**
* Check whether the code is running in a web environment
* @returns {boolean}
*/
export function isWebEnvironment() {
return typeof window === "object";
}
/**
* Check whether the code is running in a worker
* @returns {boolean}
*/
export function isWorkerEnvironment() {
return typeof importScripts === "function";
2018-03-27 00:14:23 +02:00
}
2016-11-28 11:42:58 +01:00
export default Utils;
2016-11-28 11:42:58 +01:00
/**
* Removes all duplicates from an array.
*
* @returns {Array}
*
* @example
* // returns [3,6,4,8,2]
* [3,6,4,8,4,2,3].unique();
*
* // returns ["One", "Two", "Three"]
* ["One", "Two", "Three", "One"].unique();
*/
Array.prototype.unique = function() {
const u = {}, a = [];
2017-04-13 19:08:50 +02:00
for (let i = 0, l = this.length; i < l; i++) {
2019-07-05 13:22:52 +02:00
if (Object.prototype.hasOwnProperty.call(u, this[i])) {
2016-11-28 11:42:58 +01:00
continue;
}
a.push(this[i]);
u[this[i]] = 1;
}
return a;
};
/**
* Returns the largest value in the array.
*
* @returns {number}
*
* @example
* // returns 7
* [4,2,5,3,7].max();
*/
Array.prototype.max = function() {
return Math.max.apply(null, this);
};
/**
* Returns the smallest value in the array.
*
* @returns {number}
*
* @example
* // returns 2
* [4,2,5,3,7].min();
*/
Array.prototype.min = function() {
return Math.min.apply(null, this);
};
/**
* Sums all the values in an array.
*
* @returns {number}
*
* @example
* // returns 21
* [4,2,5,3,7].sum();
*/
Array.prototype.sum = function() {
return this.reduce(function (a, b) {
return a + b;
}, 0);
};
/**
* Determine whether two arrays are equal or not.
*
* @param {Object[]} other
* @returns {boolean}
*
* @example
* // returns true
* [1,2,3].equals([1,2,3]);
*
* // returns false
* [1,2,3].equals([3,2,1]);
*/
Array.prototype.equals = function(other) {
if (!other) return false;
2017-04-13 19:08:50 +02:00
let i = this.length;
2016-12-14 17:39:17 +01:00
if (i !== other.length) return false;
2016-11-28 11:42:58 +01:00
while (i--) {
if (this[i] !== other[i]) return false;
}
return true;
};
/**
* Counts the number of times a char appears in a string.
*
* @param {char} chr
* @returns {number}
*
* @example
* // returns 2
* "Hello".count("l");
*/
String.prototype.count = function(chr) {
return this.split(chr).length - 1;
};
/**
* Wrapper for self.sendStatusMessage to handle different environments.
*
* @param {string} msg
*/
export function sendStatusMessage(msg) {
if (isWorkerEnvironment())
self.sendStatusMessage(msg);
else if (isWebEnvironment())
app.alert(msg, 10000);
else if (isNodeEnvironment() && !global.TESTING)
// eslint-disable-next-line no-console
console.debug(msg);
}
const debounceTimeouts = {};
/**
* Debouncer to stop functions from being executed multiple times in a
* short space of time
* https://davidwalsh.name/javascript-debounce-function
*
* @param {function} func - The function to be executed after the debounce time
* @param {number} wait - The time (ms) to wait before executing the function
* @param {string} id - Unique ID to reference the timeout for the function
* @param {object} scope - The object to bind to the debounced function
* @param {array} args - Array of arguments to be passed to func
* @returns {function}
*/
export function debounce(func, wait, id, scope, args) {
return function() {
const later = function() {
func.apply(scope, args);
};
clearTimeout(debounceTimeouts[id]);
debounceTimeouts[id] = setTimeout(later, wait);
};
}
/*
* Polyfills
*/
// https://github.com/uxitten/polyfill/blob/master/string.polyfill.js
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padStart
if (!String.prototype.padStart) {
String.prototype.padStart = function padStart(targetLength, padString) {
2019-11-14 09:55:27 +01:00
targetLength = targetLength>>0; // floor if number or convert non-number to 0;
padString = String((typeof padString !== "undefined" ? padString : " "));
if (this.length > targetLength) {
return String(this);
} else {
targetLength = targetLength-this.length;
if (targetLength > padString.length) {
2019-11-14 09:55:27 +01:00
padString += padString.repeat(targetLength/padString.length); // append to original to ensure we are longer than needed
}
return padString.slice(0, targetLength) + String(this);
}
};
}
// https://github.com/uxitten/polyfill/blob/master/string.polyfill.js
// https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/String/padEnd
if (!String.prototype.padEnd) {
String.prototype.padEnd = function padEnd(targetLength, padString) {
2019-11-14 09:55:27 +01:00
targetLength = targetLength>>0; // floor if number or convert non-number to 0;
padString = String((typeof padString !== "undefined" ? padString : " "));
if (this.length > targetLength) {
return String(this);
} else {
targetLength = targetLength-this.length;
if (targetLength > padString.length) {
2019-11-14 09:55:27 +01:00
padString += padString.repeat(targetLength/padString.length); // append to original to ensure we are longer than needed
}
return String(this) + padString.slice(0, targetLength);
}
};
}