Greasy Fork is available in English.

Basic Functions (For userscripts)

Useful functions for myself

Versión del día 06/02/2025. Echa un vistazo a la versión más reciente.

Este script no debería instalarse directamente. Es una biblioteca que utilizan otros scripts mediante la meta-directiva de inclusión // @require https://update.greatest.deepsurf.us/scripts/456034/1532680/Basic%20Functions%20%28For%20userscripts%29.js

  1. // ==UserScript==
  2. // @name Basic Functions (For userscripts)
  3. // @name:zh-CN 常用函数(用户脚本)
  4. // @name:en Basic Functions (For userscripts)
  5. // @namespace PY-DNG Userscripts
  6. // @version 1.4
  7. // @description Useful functions for myself
  8. // @description:zh-CN 自用函数
  9. // @description:en Useful functions for myself
  10. // @author PY-DNG
  11. // @license GPL-3.0-or-later
  12. // ==/UserScript==
  13.  
  14. /* eslint-disable no-multi-spaces */
  15. /* eslint-disable no-return-assign */
  16.  
  17. // Note: version 0.8.2.1 is modified just the license and it's not uploaded to GF yet 23-11-26 15:03
  18. // Note: version 0.8.3.1 is added just the description of parseArgs and has not uploaded to GF yet 24-02-03 18:55
  19.  
  20. let [
  21. // Console & Debug
  22. LogLevel, DoLog, Err, Assert,
  23.  
  24. // DOM
  25. $, $All, $CrE, $AEL, $$CrE, addStyle, detectDom, destroyEvent,
  26.  
  27. // Data
  28. copyProp, copyProps, parseArgs, escJsStr, replaceText,
  29.  
  30. // Environment & Browser
  31. getUrlArgv, dl_browser, dl_GM,
  32.  
  33. // Logic & Task
  34. AsyncManager, queueTask, FunctionLoader, loadFuncs, require, isLoaded
  35. ] = (function() {
  36. const [LogLevel, DoLog] = (function() {
  37. /**
  38. * level defination for DoLog function, bigger ones has higher possibility to be printed in console
  39. * @typedef {Object} LogLevel
  40. * @property {0} None - 0
  41. * @property {1} Error - 1
  42. * @property {2} Success - 2
  43. * @property {3} Warning - 3
  44. * @property {4} Info - 4
  45. */
  46. /** @type {LogLevel} */
  47. const LogLevel = {
  48. None: 0,
  49. Error: 1,
  50. Success: 2,
  51. Warning: 3,
  52. Info: 4,
  53. };
  54.  
  55. return [LogLevel, DoLog];
  56.  
  57. /**
  58. * @overload
  59. * @param {String} content - log content
  60. */
  61. /**
  62. * @overload
  63. * @param {Number} level - level specified in LogLevel object
  64. * @param {String} content - log content
  65. */
  66. /**
  67. * Logger with level and logger function specification
  68. * @overload
  69. * @param {Number} level - level specified in LogLevel object
  70. * @param {String} content - log content
  71. * @param {String} logger - which log function to use (in window.console[logger])
  72. */
  73. function DoLog() {
  74. // Get window
  75. const win = (typeof(unsafeWindow) === 'object' && unsafeWindow !== null) ? unsafeWindow : window;
  76.  
  77. const LogLevelMap = {};
  78. LogLevelMap[LogLevel.None] = {
  79. prefix: '',
  80. color: 'color:#ffffff'
  81. }
  82. LogLevelMap[LogLevel.Error] = {
  83. prefix: '[Error]',
  84. color: 'color:#ff0000'
  85. }
  86. LogLevelMap[LogLevel.Success] = {
  87. prefix: '[Success]',
  88. color: 'color:#00aa00'
  89. }
  90. LogLevelMap[LogLevel.Warning] = {
  91. prefix: '[Warning]',
  92. color: 'color:#ffa500'
  93. }
  94. LogLevelMap[LogLevel.Info] = {
  95. prefix: '[Info]',
  96. color: 'color:#888888'
  97. }
  98. LogLevelMap[LogLevel.Elements] = {
  99. prefix: '[Elements]',
  100. color: 'color:#000000'
  101. }
  102.  
  103. // Current log level
  104. DoLog.logLevel = (win.isPY_DNG && win.userscriptDebugging) ? LogLevel.Info : LogLevel.Warning; // Info Warning Success Error
  105.  
  106. // Log counter
  107. DoLog.logCount === undefined && (DoLog.logCount = 0);
  108.  
  109. // Get args
  110. let [level, logContent, logger] = parseArgs([...arguments], [
  111. [2],
  112. [1,2],
  113. [1,2,3]
  114. ], [LogLevel.Info, 'DoLog initialized.', 'log']);
  115.  
  116. let msg = '%c' + LogLevelMap[level].prefix + (typeof GM_info === 'object' ? `[${GM_info.script.name}]` : '') + (LogLevelMap[level].prefix ? ' ' : '');
  117. let subst = LogLevelMap[level].color;
  118.  
  119. switch (typeof(logContent)) {
  120. case 'string':
  121. msg += '%s';
  122. break;
  123. case 'number':
  124. msg += '%d';
  125. break;
  126. default:
  127. msg += '%o';
  128. break;
  129. }
  130.  
  131. // Log when log level permits
  132. if (level <= DoLog.logLevel) {
  133. // Log to console when log level permits
  134. if (level <= DoLog.logLevel) {
  135. if (++DoLog.logCount > 512) {
  136. console.clear();
  137. DoLog.logCount = 0;
  138. }
  139. console[logger](msg, subst, logContent);
  140. }
  141. }
  142. }
  143. }) ();
  144.  
  145. /**
  146. * Throw an error
  147. * @param {String} msg - the error message
  148. * @param {Error} [ErrorConstructor=Error] - which error constructor to use, defaulting to Error()
  149. */
  150. function Err(msg, ErrorConstructor=Error) {
  151. throw new ErrorConstructor((typeof GM_info === 'object' ? `[${GM_info.script.name}]` : '') + msg);
  152. }
  153.  
  154. /**
  155. * Assert given condition is true-like, otherwise throws given error
  156. * @param {*} condition
  157. * @param {string} errmsg
  158. * @param {Error} [ErrorConstructor=Error]
  159. */
  160. function Assert(condition, errmsg, ErrorConstructor=Error) {
  161. condition || Err(errmsg, ErrorConstructor);
  162. }
  163.  
  164. /**
  165. * Convenient function to querySelector
  166. * @overload
  167. * @param {Element|Document|DocumentFragment} [root] - which target to call querySelector on
  168. * @param {string} selector - querySelector selector
  169. * @returns {Element|null}
  170. */
  171. function $() {
  172. switch(arguments.length) {
  173. case 2:
  174. return arguments[0].querySelector(arguments[1]);
  175. default:
  176. return document.querySelector(arguments[0]);
  177. }
  178. }
  179. /**
  180. * Convenient function to querySelectorAll
  181. * @overload
  182. * @param {Element|Document|DocumentFragment} [root] - which target to call querySelectorAll on
  183. * @param {string} selector - querySelectorAll selector
  184. * @returns {NodeList}
  185. */
  186. function $All() {
  187. switch(arguments.length) {
  188. case 2:
  189. return arguments[0].querySelectorAll(arguments[1]);
  190. break;
  191. default:
  192. return document.querySelectorAll(arguments[0]);
  193. }
  194. }
  195. /**
  196. * Convenient function to querySelectorAll
  197. * @overload
  198. * @param {Document} [root] - which document to call createElement on
  199. * @param {string} tagName
  200. */
  201. function $CrE() {
  202. switch(arguments.length) {
  203. case 2:
  204. return arguments[0].createElement(arguments[1]);
  205. break;
  206. default:
  207. return document.createElement(arguments[0]);
  208. }
  209. }
  210. /**
  211. * Convenient function to addEventListener
  212. * @overload
  213. * @param {EventTarget} target - which target to call addEventListener on
  214. * @param {string} type
  215. * @param {EventListenerOrEventListenerObject | null} callback
  216. * @param {AddEventListenerOptions | boolean} [options]
  217. */
  218. function $AEL(...args) {
  219. /** @type {EventTarget} */
  220. const target = args.shift();
  221. return target.addEventListener.apply(target, args);
  222. }
  223. /**
  224. * @typedef {[type: string, callback: EventListenerOrEventListenerObject | null, options: AddEventListenerOptions | boolean]} $AEL_Arguments
  225. */
  226. /**
  227. * @typedef {Object} $$CrE_Options
  228. * @property {string} tagName
  229. * @property {object} [props] - properties set by `element[prop] = value;`
  230. * @property {object} [attrs] - attributes set by `element.setAttribute(attr, value);`
  231. * @property {string | string[]} [classes] - class names to be set
  232. * @property {object} [styles] - styles set by `element[style_name] = style_value;`
  233. * @property {$AEL_Arguments[]} [listeners] - event listeners added by `$AEL(element, ...listener);`
  234. */
  235. /**
  236. * @overload
  237. * @param {$$CrE_Options} options
  238. */
  239. /**
  240. * Create configorated element
  241. * @overload
  242. * @param {string} tagName
  243. * @param {object} [props] - properties set by `element[prop] = value;`
  244. * @param {object} [attrs] - attributes set by `element.setAttribute(attr, value);`
  245. * @param {string | string[]} [classes] - class names to be set
  246. * @param {object} [styles] - styles set by `element[style_name] = style_value;`
  247. * @param {$AEL_Arguments[]} [listeners] - event listeners added by `$AEL(element, ...listener);`
  248. * @returns {HTMLElement}
  249. */
  250. function $$CrE() {
  251. const [tagName, props, attrs, classes, styles, listeners] = parseArgs([...arguments], [
  252. function(args, defaultValues) {
  253. const arg = args[0];
  254. return {
  255. 'string': () => [arg, ...defaultValues.filter((arg, i) => i > 0)],
  256. 'object': () => ['tagName', 'props', 'attrs', 'classes', 'styles', 'listeners'].map((prop, i) => arg.hasOwnProperty(prop) ? arg[prop] : defaultValues[i])
  257. }[typeof arg]();
  258. },
  259. [1,2],
  260. [1,2,3],
  261. [1,2,3,4],
  262. [1,2,3,4,5]
  263. ], ['div', {}, {}, [], {}, []]);
  264. const elm = $CrE(tagName);
  265. for (const [name, val] of Object.entries(props)) {
  266. elm[name] = val;
  267. }
  268. for (const [name, val] of Object.entries(attrs)) {
  269. elm.setAttribute(name, val);
  270. }
  271. for (const cls of Array.isArray(classes) ? classes : [classes]) {
  272. elm.classList.add(cls);
  273. }
  274. for (const [name, val] of Object.entries(styles)) {
  275. elm.style[name] = val;
  276. }
  277. for (const listener of listeners) {
  278. $AEL(elm, ...listener);
  279. }
  280. return elm;
  281. }
  282.  
  283. /**
  284. * @overload
  285. * @param {string} css - css content
  286. * @returns {HTMLStyleElement}
  287. */
  288. /**
  289. * @overload
  290. * @param {string} css - css content
  291. * @param {string} id - `id` attribute for <style> element
  292. * @returns {HTMLStyleElement}
  293. */
  294. /**
  295. * Append a style text to document(<head>) with a <style> element \
  296. * removes existing <style> elements with same id if id provided, so style updates can be done by using one same id
  297. *
  298. * Uses `GM_addElement` if `GM_addElement` exists and param `id` not specified. (`GM_addElement` uses id attribute, so specifing id manually when using `GM_addElement` takes no effect) \
  299. * In another case `GM_addStyle` instead of `GM_addElement` exists, and both `id` and `parentElement` not specified, `GM_addStyle` will be used. \
  300. * `document.createElement('style')` will be used otherwise.
  301. * @overload
  302. * @param {HTMLElement} parentElement - parent element to place <style> element
  303. * @param {string} css - css content
  304. * @param {string} id - `id` attribute for <style> element
  305. * @returns {HTMLStyleElement}
  306. */
  307. function addStyle() {
  308. // Get arguments
  309. const [parentElement, css, id] = parseArgs([...arguments], [
  310. [2],
  311. [2,3],
  312. [1,2,3]
  313. ], [null, '', null]);
  314.  
  315. if (typeof GM_addElement === 'function' && id === null) {
  316. return GM_addElement(parentElement, 'style', { textContent: css });
  317. } else if (typeof GM_addStyle === 'function' && parentElement === null && id === null) {
  318. return GM_addStyle(css);
  319. } else {
  320. // Make <style>
  321. const style = $CrE('style');
  322. style.innerText = css;
  323. id !== null && (style.id = id);
  324. id !== null && Array.from($All(`style#${id}`)).forEach(elm => elm.remove());
  325.  
  326. // Append to parentElement
  327. (parentElement ?? document.head).appendChild(style);
  328. return style;
  329. }
  330. }
  331.  
  332. /**
  333. * @typedef {Object} detectDom_options
  334. * @property {Node} root - root target to observe on
  335. * @property {string | string[]} [selector] - selector(s) to observe for, be aware that in options object it is named selector, but is named selectors in param
  336. * @property {boolean} [attributes] - whether to observe existing elements' attribute changes
  337. * @property {function} [callback] - if provided, use callback instead of Promise when selector element found
  338. */
  339. /**
  340. * @overload
  341. * @param {detectDom_options} options
  342. * @returns {MutationObserver}
  343. */
  344. /**
  345. * Get callback / resolve promise when specific dom/element appearce in document \
  346. * uses MutationObserver for implementation \
  347. * This behavior is different from versions that equals to or older than 0.8.4.2, so be careful when using it.
  348. * @overload
  349. * @param {Node} root - root target to observe on
  350. * @param {string | string[]} [selectors] - selector(s) to observe for
  351. * @param {boolean} [attributes] - whether to observe existing elements' attribute changes
  352. * @param {function} [callback] - if provided, use callback instead of Promise when selector element found
  353. * @returns {MutationObserver}
  354. */
  355. function detectDom() {
  356. let [selectors, root, attributes, callback] = parseArgs([...arguments], [
  357. function(args, defaultValues) {
  358. const arg = args[0];
  359. return {
  360. 'string': () => [arg, ...defaultValues.filter((arg, i) => i > 0)],
  361. 'object': () => ['selector', 'root', 'attributes', 'callback'].map((prop, i) => arg.hasOwnProperty(prop) ? arg[prop] : defaultValues[i])
  362. }[typeof arg]();
  363. },
  364. [2,1],
  365. [2,1,3],
  366. [2,1,3,4],
  367. ], [[''], document, false, null]);
  368. !Array.isArray(selectors) && (selectors = [selectors]);
  369.  
  370. if (select(root, selectors)) {
  371. for (const elm of selectAll(root, selectors)) {
  372. if (callback) {
  373. setTimeout(callback.bind(null, elm));
  374. } else {
  375. return Promise.resolve(elm);
  376. }
  377. }
  378. }
  379.  
  380. const observer = new MutationObserver(mCallback);
  381. observer.observe(root, {
  382. childList: true,
  383. subtree: true,
  384. attributes,
  385. });
  386.  
  387. let isPromise = !callback;
  388. return callback ? observer : new Promise((resolve, reject) => callback = resolve);
  389.  
  390. function mCallback(mutationList, observer) {
  391. const addedNodes = mutationList.reduce((an, mutation) => {
  392. switch (mutation.type) {
  393. case 'childList':
  394. an.push(...mutation.addedNodes);
  395. break;
  396. case 'attributes':
  397. an.push(mutation.target);
  398. break;
  399. }
  400. return an;
  401. }, []);
  402. const addedSelectorNodes = addedNodes.reduce((nodes, anode) => {
  403. if (anode.matches && match(anode, selectors)) {
  404. nodes.add(anode);
  405. }
  406. const childMatches = anode.querySelectorAll ? selectAll(anode, selectors) : [];
  407. for (const cm of childMatches) {
  408. nodes.add(cm);
  409. }
  410. return nodes;
  411. }, new Set());
  412. for (const node of addedSelectorNodes) {
  413. callback(node);
  414. isPromise && observer.disconnect();
  415. }
  416. }
  417.  
  418. function selectAll(elm, selectors) {
  419. !Array.isArray(selectors) && (selectors = [selectors]);
  420. return selectors.map(selector => [...$All(elm, selector)]).reduce((all, arr) => {
  421. all.push(...arr);
  422. return all;
  423. }, []);
  424. }
  425.  
  426. function select(elm, selectors) {
  427. const all = selectAll(elm, selectors);
  428. return all.length ? all[0] : null;
  429. }
  430.  
  431. function match(elm, selectors) {
  432. return !!elm.matches && selectors.some(selector => elm.matches(selector));
  433. }
  434. }
  435.  
  436. /**
  437. * Just stopPropagation and preventDefault
  438. * @param {Event} e
  439. */
  440. function destroyEvent(e) {
  441. if (!e) {return false;};
  442. if (!e instanceof Event) {return false;};
  443. e.stopPropagation();
  444. e.preventDefault();
  445. }
  446.  
  447. /**
  448. * copy property value from obj1 to obj2 if exists
  449. * @param {object} obj1
  450. * @param {object} obj2
  451. * @param {string|Symbol} prop
  452. */
  453. function copyProp(obj1, obj2, prop) {obj1.hasOwnProperty(prop) && (obj2[prop] = obj1[prop]);}
  454. /**
  455. * copy property values from obj1 to obj2 if exists
  456. * @param {object} obj1
  457. * @param {object} obj2
  458. * @param {string|Symbol} [props] - properties to copy, copy all enumerable properties if not specified
  459. */
  460. function copyProps(obj1, obj2, props) {(props ?? Object.keys(obj1)).forEach((prop) => (copyProp(obj1, obj2, prop)));}
  461.  
  462. /**
  463. * Argument parser with sorting and defaultValue support \
  464. * See use cases in other functions
  465. * @param {Array} args - original arguments' value to be parsed
  466. * @param {(number[]|function)[]} rules - rules to sort arguments or custom function to parse arguments
  467. * @param {Array} defaultValues - default values for arguments not provided a value
  468. * @returns {Array}
  469. */
  470. function parseArgs(args, rules, defaultValues=[]) {
  471. // args and rules should be array, but not just iterable (string is also iterable)
  472. if (!Array.isArray(args) || !Array.isArray(rules)) {
  473. throw new TypeError('parseArgs: args and rules should be array')
  474. }
  475.  
  476. // fill rules[0]
  477. (!Array.isArray(rules[0]) || rules[0].length === 1) && rules.splice(0, 0, []);
  478.  
  479. // max arguments length
  480. const count = rules.length - 1;
  481.  
  482. // args.length must <= count
  483. if (args.length > count) {
  484. throw new TypeError(`parseArgs: args has more elements(${args.length}) longer than ruless'(${count})`);
  485. }
  486.  
  487. // rules[i].length should be === i if rules[i] is an array, otherwise it should be a function
  488. for (let i = 1; i <= count; i++) {
  489. const rule = rules[i];
  490. if (Array.isArray(rule)) {
  491. if (rule.length !== i) {
  492. throw new TypeError(`parseArgs: rules[${i}](${rule}) should have ${i} numbers, but given ${rules[i].length}`);
  493. }
  494. if (!rule.every((num) => (typeof num === 'number' && num <= count))) {
  495. throw new TypeError(`parseArgs: rules[${i}](${rule}) should contain numbers smaller than count(${count}) only`);
  496. }
  497. } else if (typeof rule !== 'function') {
  498. throw new TypeError(`parseArgs: rules[${i}](${rule}) should be an array or a function.`)
  499. }
  500. }
  501.  
  502. // Parse
  503. const rule = rules[args.length];
  504. let parsed;
  505. if (Array.isArray(rule)) {
  506. parsed = [...defaultValues];
  507. for (let i = 0; i < rule.length; i++) {
  508. parsed[rule[i]-1] = args[i];
  509. }
  510. } else {
  511. parsed = rule(args, defaultValues);
  512. }
  513. return parsed;
  514. }
  515.  
  516. /**
  517. * escape str into javascript written format
  518. * @param {string} str
  519. * @param {string} [quote]
  520. * @returns
  521. */
  522. function escJsStr(str, quote='"') {
  523. str = str.replaceAll('\\', '\\\\').replaceAll(quote, '\\' + quote).replaceAll('\t', '\\t');
  524. str = quote === '`' ? str.replaceAll(/(\$\{[^\}]*\})/g, '\\$1') : str.replaceAll('\r', '\\r').replaceAll('\n', '\\n');
  525. return quote + str + quote;
  526. }
  527.  
  528. /**
  529. * Replace given text with no mismatching of replacing replaced text
  530. *
  531. * e.g. replaceText('aaaabbbbccccdddd', {'a': 'b', 'b': 'c', 'c': 'd', 'd': 'e'}) === 'bbbbccccddddeeee' \
  532. * replaceText('abcdAABBAA', {'BB': 'AA', 'AAAAAA': 'This is a trap!'}) === 'abcdAAAAAA' \
  533. * replaceText('abcd{AAAA}BB}', {'{AAAA}': '{BB', '{BBBB}': 'This is a trap!'}) === 'abcd{BBBB}' \
  534. * replaceText('abcd', {}) === 'abcd'
  535. *
  536. * **Note**: \
  537. * replaceText will replace in sort of replacer's iterating sort \
  538. * e.g. currently replaceText('abcdAABBAA', {'BBAA': 'TEXT', 'AABB': 'TEXT'}) === 'abcdAATEXT' \
  539. * but remember: (As MDN Web Doc said,) Although the keys of an ordinary Object are ordered now, this was \
  540. * not always the case, and the order is complex. As a result, it's best not to rely on property order. \
  541. * So, don't expect replaceText will treat replacer key-values in any specific sort. Use replaceText to \
  542. * replace irrelevance replacer keys only.
  543. * @param {string} text
  544. * @param {object} replacer
  545. * @returns {string}
  546. */
  547. function replaceText(text, replacer) {
  548. if (Object.entries(replacer).length === 0) {return text;}
  549. const [models, targets] = Object.entries(replacer);
  550. const len = models.length;
  551. let text_arr = [{text: text, replacable: true}];
  552. for (const [model, target] of Object.entries(replacer)) {
  553. text_arr = replace(text_arr, model, target);
  554. }
  555. return text_arr.map((text_obj) => (text_obj.text)).join('');
  556.  
  557. function replace(text_arr, model, target) {
  558. const result_arr = [];
  559. for (const text_obj of text_arr) {
  560. if (text_obj.replacable) {
  561. const splited = text_obj.text.split(model);
  562. for (const part of splited) {
  563. result_arr.push({text: part, replacable: true});
  564. result_arr.push({text: target, replacable: false});
  565. }
  566. result_arr.pop();
  567. } else {
  568. result_arr.push(text_obj);
  569. }
  570. }
  571. return result_arr;
  572. }
  573. }
  574.  
  575. /**
  576. * @typedef {Object} getUrlArgv_options
  577. * @property {string} name
  578. * @property {string} [url]
  579. * @property {string} [defaultValue]
  580. * @property {function} [dealFunc] - function that inputs original getUrlArgv result and outputs final return value
  581. */
  582. /**
  583. * @overload
  584. * @param {Object} getUrlArgv_options
  585. * @returns
  586. */
  587. /**
  588. * Get a url argument from location.href
  589. * @param {string} name
  590. * @param {string} [url]
  591. * @param {string} [defaultValue]
  592. * @param {function} [dealFunc] - function that inputs original getUrlArgv result and outputs final return value
  593. */
  594. function getUrlArgv() {
  595. const [name, url, defaultValue, dealFunc] = parseArgs([...arguments], [
  596. function(args, defaultValues) {
  597. const arg = args[0];
  598. return {
  599. 'string': () => [arg, ...defaultValues.filter((arg, i) => i > 0)],
  600. 'object': () => ['name', 'url', 'defaultValue', 'dealFunc'].map((prop, i) => arg.hasOwnProperty(prop) ? arg[prop] : defaultValues[i])
  601. }[typeof arg]();
  602. },
  603. [2,1],
  604. [2,1,3],
  605. [2,1,3,4]
  606. ], [null, location.href, null, a => a]);
  607.  
  608. if (name === null) { return null; }
  609.  
  610. const search = new URL(url).search;
  611. const objSearch = new URLSearchParams(search);
  612. const raw = objSearch.has(name) ? objSearch.get(name) : defaultValue;
  613. const argv = dealFunc(raw);
  614.  
  615. return argv;
  616. }
  617.  
  618. /**
  619. * download file from given url by simulating <a download="..." href=""></a> clicks\
  620. * a common use case is to download Blob objects as file from `URL.createObjectURL`
  621. * @param {string} url
  622. * @param {string} filename
  623. */
  624. function dl_browser(url, filename) {
  625. const a = document.createElement('a');
  626. a.href = url;
  627. a.download = filename;
  628. a.click();
  629. }
  630.  
  631. /**
  632. * File download function\
  633. * details looks like the detail of GM_xmlhttpRequest\
  634. * onload function will be called after file saved to disk
  635. * @param {object} details
  636. */
  637. function dl_GM(details) {
  638. if (!details.url || !details.name) {return false;};
  639.  
  640. // Configure request object
  641. const requestObj = {
  642. url: details.url,
  643. responseType: 'blob',
  644. onload: function(e) {
  645. // Save file
  646. dl_browser(URL.createObjectURL(e.response), details.name);
  647.  
  648. // onload callback
  649. details.onload ? details.onload(e) : function() {};
  650. }
  651. }
  652. if (details.onloadstart ) {requestObj.onloadstart = details.onloadstart;};
  653. if (details.onprogress ) {requestObj.onprogress = details.onprogress;};
  654. if (details.onerror ) {requestObj.onerror = details.onerror;};
  655. if (details.onabort ) {requestObj.onabort = details.onabort;};
  656. if (details.onreadystatechange) {requestObj.onreadystatechange = details.onreadystatechange;};
  657. if (details.ontimeout ) {requestObj.ontimeout = details.ontimeout;};
  658.  
  659. // Send request
  660. Assert(typeof GM_xmlhttpRequest === 'function', 'GM_xmlhttpRequest should be provided in order to use dl_GM', TypeError);
  661. GM_xmlhttpRequest(requestObj);
  662. }
  663.  
  664. /**
  665. * Manager to manager async tasks\
  666. * This was written when I haven't learnt Promise, so for fluent promise users, just ignore it:)
  667. *
  668. * # Usage
  669. * ```javascript
  670. * // This simulates a async task, it can be a XMLHttpRequest, some file reading, or so on...
  671. * function someAsyncTask(callback, duration) {
  672. * const result = Math.random();
  673. * setTimeout(() => callback(result), duration);
  674. * }
  675. *
  676. * // Do 10 async tasks, and log all results when all async tasks finished
  677. * const AM = new AsyncManager();
  678. * const results = [];
  679. * AM.onfinish = function() {
  680. * console.log('All tasks finished!');
  681. * console.log(results);
  682. * }
  683. *
  684. * for (let i = 0; i < 10; i++) {
  685. * AM.add();
  686. * const duration = (Math.random() * 5 + 5) * 1000;
  687. * const index = i;
  688. * someAsyncTask(result => {
  689. * console.log(`Task ${index} finished after ${duration}ms!`);
  690. * results[index] = result;
  691. * }, duration);
  692. * console.log(`Task ${index} started!`);
  693. * }
  694. *
  695. * // Set AM.finishEvent to true after all tasks added, allowing AsyncManager to call onfinish callback
  696. * ```
  697. * @constructor
  698. */
  699. function AsyncManager() {
  700. const AM = this;
  701.  
  702. // Ongoing tasks count
  703. this.taskCount = 0;
  704.  
  705. // Whether generate finish events
  706. let finishEvent = false;
  707. Object.defineProperty(this, 'finishEvent', {
  708. configurable: true,
  709. enumerable: true,
  710. get: () => (finishEvent),
  711. set: (b) => {
  712. finishEvent = b;
  713. b && AM.taskCount === 0 && AM.onfinish && AM.onfinish();
  714. }
  715. });
  716.  
  717. // Add one task
  718. this.add = () => (++AM.taskCount);
  719.  
  720. // Finish one task
  721. this.finish = () => ((--AM.taskCount === 0 && AM.finishEvent && AM.onfinish && AM.onfinish(), AM.taskCount));
  722. }
  723.  
  724. /**
  725. * Put tasks in specific queue and order their execution
  726. * Set `queueTask[queueId].max`, `queueTask[queueId].sleep` to custom queue's max ongoing tasks and sleep time between tasks
  727. * @param {function} task - task function to run
  728. * @param {string | Symbol} queueId - identifier to specify a target queue. if provided, given task will be added into specified queue.
  729. * @returns
  730. */
  731. function queueTask(task, queueId='default') {
  732. init();
  733.  
  734. return new Promise((resolve, reject) => {
  735. queueTask.hasOwnProperty(queueId) || (queueTask[queueId] = { tasks: [], ongoing: 0 });
  736. queueTask[queueId].tasks.push({task, resolve, reject});
  737. checkTask(queueId);
  738. });
  739.  
  740. function init() {
  741. if (!queueTask[queueId]?.initialized) {
  742. queueTask[queueId] = {
  743. // defaults
  744. tasks: [],
  745. ongoing: 0,
  746. max: 3,
  747. sleep: 500,
  748.  
  749. // user's pre-sets
  750. ...(queueTask[queueId] || {}),
  751.  
  752. // initialized flag
  753. initialized: true
  754. }
  755. };
  756. }
  757.  
  758. function checkTask() {
  759. const queue = queueTask[queueId];
  760. setTimeout(() => {
  761. if (queue.ongoing < queue.max && queue.tasks.length) {
  762. const task = queue.tasks.shift();
  763. queue.ongoing++;
  764. setTimeout(
  765. () => task.task().then(v => {
  766. queue.ongoing--;
  767. task.resolve(v);
  768. checkTask(queueId);
  769. }).catch(e => {
  770. queue.ongoing--;
  771. task.reject(e);
  772. checkTask(queueId);
  773. }),
  774. queue.sleep
  775. );
  776. }
  777. });
  778. }
  779. }
  780.  
  781. const [FunctionLoader, loadFuncs, require, isLoaded] = (function() {
  782. /**
  783. * 一般用作函数对象oFunc的加载条件,检测当前环境是否适合/需要该oFunc加载
  784. * @typedef {Object} checker_func
  785. * @property {string} type - checker's identifier
  786. * @property {function} func - actual internal judgement implementation
  787. */
  788. /**
  789. * 一般用作函数对象oFunc的加载条件,检测当前环境是否适合/需要该oFunc加载
  790. * @typedef {Object} checker
  791. * @property {string} type - checker's identifier
  792. * @property {*} value - param that goes into checker function
  793. */
  794. /**
  795. * 需要使用的substorage名称
  796. * @typedef {"GM_setValue" | "GM_getValue" | "GM_listValues" | "GM_deleteValue"} substorage_value
  797. */
  798. /**
  799. * 可以传入params的字符串名称
  800. * @typedef {'oFunc' | substorage_value} param
  801. */
  802. /**
  803. * 被加载函数对象的func函数
  804. * @callback oFuncBody
  805. * @param {oFunc} oFunc
  806. * @returns {*|Promise<*>}
  807. */
  808. /**
  809. * 被加载执行的函数对象
  810. * @typedef {Object} oFunc
  811. * @property {string} id - 每次load(每个FuncPool实例)内唯一的标识符
  812. * @property {boolean} [disabled] - 为真值时,无论checkers还是detectDom等任何其他条件通过或未通过,均不执行此函数对象;默认为false
  813. * @property {checker[]|checker} [checkers] - oFunc执行的条件
  814. * @property {string[]|string} [detectDom] - 如果提供,开始checker检查前会首先等待其中所有css选择器对应的元素在document中出现
  815. * @property {string[]|string} [dependencies] - 如果提供,应为其他函数对象的id或者id列表;开始checker检查前会首先等待其中所有指定的函数对象加载完毕
  816. * @property {boolean} [readonly] - 指定该函数的返回值是否应该被Proxy保护为不可修改对象
  817. * @property {param[]|param} params - 可选,指定传入oFunc.func的参数列表;可以为参数本身或其组成的数组
  818. * 参数可以为 字符串 或是 其他类型,如果是字符串就传入对应的FunctionLoader提供的内置值(见下),如果是其他类型则按照原样传入
  819. * - "oFunc":
  820. * 函数对象本身
  821. * - "GM_setValue", "GM_getValue", "GM_listValues", "GM_deleteValue":
  822. * 和脚本管理器提供的函数一致,但是读取和写入的对象是以oFunc.id为键的子空间
  823. * 比如,GM_getValue("prop") 就相当于调用脚本管理器提供的的 GM_getValue(oFunc.id)["prop"]
  824. * @property {oFuncBody} func - 实际实现了功能的函数
  825. * @property {boolean} [STOP] - [调试用] 指定不执行此函数对象
  826. */
  827.  
  828. const registered_checkers = {
  829. switch: value => value,
  830. url: value => location.href === value,
  831. path: value => location.pathname === value,
  832. regurl: value => !!location.href.match(value),
  833. regpath: value => !!location.pathname.match(value),
  834. starturl: value => location.href.startsWith(value),
  835. startpath: value => location.pathname.startsWith(value),
  836. func: value => value()
  837. };
  838.  
  839. class FuncPool extends EventTarget {
  840. static #STILL_LOADING = Symbol('oFunc still loading');
  841. static FunctionNotFound = Symbol('Function not found');
  842. static FunctionNotLoaded = Symbol('Function not loaded');
  843.  
  844. /** @typedef {symbol|*} return_value */
  845. /** @type {Map<oFunc, return_value>} */
  846. #oFuncs = new Map();
  847.  
  848. /**
  849. * 创建新函数池,并加载提供的函数对象
  850. * @param {oFunc[]|oFunc} [oFuncs] - 可选,需要加载的函数对象或其数组,不提供时默认为空数组
  851. * @returns {FuncPool}
  852. */
  853. constructor(oFuncs=[]) {
  854. super();
  855. this.load(oFuncs);
  856. }
  857.  
  858. /**
  859. * 加载提供的一个或多个函数对象,并将其加入到函数池中
  860. * @param {oFunc[]|oFunc} [oFuncs] - 可选,需要加载的函数对象或其数组,不提供时默认为空数组
  861. */
  862. load(oFuncs=[]) {
  863. oFuncs = Array.isArray(oFuncs) ? oFuncs : [oFuncs];
  864. for (const oFunc of oFuncs) {
  865. this.#load(oFunc);
  866. }
  867. }
  868.  
  869. /**
  870. * 加载一个函数对象,并将其加入到函数池中
  871. * 当id重复时,直接报错RedeclarationError
  872. * 异步函数,当彻底load完毕/checkers确定不加载时resolve
  873. * 当加载完毕时,广播load事件;如果全部加载完毕,还广播all_load事件
  874. * @param {oFunc} oFunc
  875. * @returns {Promise<undefined>}
  876. */
  877. async #load(oFunc) {
  878. const that = this;
  879.  
  880. // disabled的函数对象,不执行
  881. if (oFunc.disabled) {
  882. return;
  883. }
  884.  
  885. // 已经在函数池中的函数对象,不重复load
  886. if (this.#oFuncs.has(oFunc)) {
  887. return;
  888. }
  889.  
  890. // 检查有无重复id
  891. for (const o of this.#oFuncs.keys()) {
  892. if (o.id === oFunc.id) {
  893. throw new RedeclarationError(`Attempts to load oFunc with id already in use: ${oFunc.id}`);
  894. }
  895. }
  896.  
  897. // 设置当前返回值为STILL_LOADING
  898. this.#oFuncs.set(oFunc, FuncPool.#STILL_LOADING);
  899.  
  900. // 加载依赖
  901. const dependencies = Array.isArray(oFunc.dependencies) ? oFunc.dependencies : ( oFunc.dependencies ? [oFunc.dependencies] : [] );
  902. const promise_deps = Promise.all(dependencies.map(id => new Promise((resolve, reject) => {
  903. $AEL(that, 'load', e => e.detail.oFunc.id === id && resolve());
  904. })));
  905.  
  906. // 检测detectDOM中css选择器指定的元素出现
  907. const selectors = Array.isArray(oFunc.detectDom) ? oFunc.detectDom : ( oFunc.detectDom ? [oFunc.detectDom] : [] );
  908. const promise_css = Promise.all(selectors.map(selector => detectDom(selector)));
  909.  
  910. // 等待上述两项完成
  911. await Promise.all([promise_deps, promise_css]);
  912.  
  913. // 检测checkers加载条件
  914. const checkers = Array.isArray(oFunc.checkers) ? oFunc.checkers : ( oFunc.checkers ? [oFunc.checkers] : [] );
  915. if (!testCheckers(checkers)) {
  916. return;
  917. }
  918.  
  919. // 处理substorage
  920. const substorage = FuncPool.#MakeSubStorage(oFunc.id);
  921.  
  922. // 处理函数参数
  923. const builtins = {
  924. oFunc,
  925. ...substorage
  926. };
  927. const params = oFunc.params ? (Array.isArray(oFunc.params) ? oFunc.params : [oFunc.params]) : [];
  928. const args = params.map(param => typeof param === 'string' ? builtins[param] : param);
  929.  
  930. // 执行函数对象
  931. const raw_return_value = oFunc.func(...args);
  932. const return_value = await Promise.resolve(raw_return_value);
  933.  
  934. // 设置返回值
  935. this.#oFuncs.set(oFunc, return_value);
  936.  
  937. // 广播事件
  938. this.dispatchEvent(new CustomEvent('load', {
  939. detail: {
  940. oFunc, id: oFunc.id, return_value
  941. }
  942. }));
  943. Array.from(this.#oFuncs.values()).every(v => v !== FuncPool.#STILL_LOADING) &&
  944. this.dispatchEvent(new CustomEvent('all_load', {}));
  945. }
  946.  
  947. /**
  948. * 获取指定函数对象的返回值
  949. * 如果指定的函数对象不存在,返回FunctionNotFound
  950. * 如果指定的函数对象存在但尚未加载,返回FunctionNotLoaded
  951. * 如果函数对象指定了readonly为真值,则返回前用Proxy包装返回值,使其不可修改
  952. * @param {string} id - 函数对象的id
  953. * @returns {*}
  954. */
  955. require(id) {
  956. for (const [oFunc, return_value] of this.#oFuncs.entries()) {
  957. if (oFunc.id === id) {
  958. if (return_value === FuncPool.#STILL_LOADING) {
  959. return FuncPool.FunctionNotLoaded;
  960. } else {
  961. return oFunc.readonly ? FuncPool.#MakeReadonlyObj(return_value) : return_value;
  962. }
  963. }
  964. }
  965. return FuncPool.FunctionNotFound;
  966. }
  967.  
  968. isLoaded(id) {
  969. for (const [oFunc, return_value] of this.#oFuncs.entries()) {
  970. if (oFunc.id === id) {
  971. if (return_value === FuncPool.#STILL_LOADING) {
  972. return false;
  973. } else {
  974. return true;
  975. }
  976. }
  977. return false;
  978. }
  979. }
  980.  
  981. /**
  982. * 以Proxy包装value,使其属性只读
  983. * 如果传入的不是object,则直接返回value
  984. * @param {Object} val
  985. * @returns {Proxy}
  986. */
  987. static #MakeReadonlyObj(val) {
  988. return isObject(val) ? new Proxy(val, {
  989. get: function(target, property, receiver) {
  990. return FuncPool.#MakeReadonlyObj(target[property]);
  991. },
  992. set: function(target, property, value, receiver) {},
  993. has: function(target, prop) {},
  994. setPrototypeOf(target, newProto) {
  995. return false;
  996. },
  997. defineProperty(target, property, descriptor) {
  998. return true;
  999. },
  1000. deleteProperty(target, property) {
  1001. return false;
  1002. },
  1003. preventExtensions(target) {
  1004. return false;
  1005. }
  1006. }) : val;
  1007.  
  1008. function isObject(value) {
  1009. return ['object', 'function'].includes(typeof value) && value !== null;
  1010. }
  1011. }
  1012.  
  1013. /**
  1014. * 创建适用于子功能函数的 GM_setValue, GM_getValue, GM_deleteValue 和 GM_listValues \
  1015. * 调用返回的`GM_setValue(str, val)`相当于对脚本管理器提供的GM*函数进行如下调用:
  1016. * ``` javascript
  1017. * const obj = GM_getValue(key, {});
  1018. * if (typeof obj !== 'object' or obj === null) { throw new TypeError(''); }
  1019. * obj[str] = val;
  1020. * GM_setValue(key, obj);
  1021. * ```
  1022. * @param {string} key - 实际调用用户脚本管理器的GM*函数时提供的key,一般是子功能函数id
  1023. * @returns {{ GM_setValue: function, GM_getValue: function, GM_deleteValue: function, GM_listValues: function }}
  1024. */
  1025. static #MakeSubStorage(key) {
  1026. const GM_funcs = {
  1027. GM_setValue: typeof GM_setValue === 'function' ? GM_setValue : null,
  1028. GM_getValue: typeof GM_getValue === 'function' ? GM_getValue : null,
  1029. GM_deleteValue: typeof GM_deleteValue === 'function' ? GM_deleteValue : null,
  1030. GM_listValues: typeof GM_listValues === 'function' ? GM_listValues : null,
  1031. }
  1032. return {
  1033. GM_setValue(name, val) {
  1034. checkGrant(['GM_setValue', 'GM_getValue'], 'GM_setValue');
  1035. const obj = GM_funcs.GM_getValue(key, {});
  1036. Assert(isObject(obj), `FunctionLoader: storage item of key ${name} should be an object`, TypeError);
  1037. obj[name] = val;
  1038. GM_funcs.GM_setValue(key, obj);
  1039. },
  1040. GM_getValue(name, default_value=null) {
  1041. checkGrant(['GM_getValue'], 'GM_getValue');
  1042. const obj = GM_funcs.GM_getValue(key, {});
  1043. return obj.hasOwnProperty(name) ? obj[name] : default_value;
  1044. },
  1045. GM_deleteValue(name) {
  1046. checkGrant(['GM_setValue', 'GM_getValue'], 'GM_deleteValue');
  1047. const obj = GM_funcs.GM_getValue(key, {});
  1048. delete obj[name];
  1049. GM_funcs.GM_setValue(key, obj);
  1050. },
  1051. GM_listValues() {
  1052. checkGrant(['GM_getValue'], 'GM_listValues');
  1053. const obj = GM_funcs.GM_getValue(key, {});
  1054. return Object.keys(obj);
  1055. }
  1056. };
  1057.  
  1058. /**
  1059. * 检查指定的GM_*函数是否存在,不存在就抛出错误
  1060. * @param {string|string[]} funcnames
  1061. * @param {string} calling - 正在调用的GM_函数的名字,输出错误信息时用
  1062. */
  1063. function checkGrant(funcnames, calling) {
  1064. Array.isArray(funcnames) || (funcnames = [funcnames]);
  1065. for (const funcname of funcnames) {
  1066. Assert(GM_funcs[funcname], `FunctionLoader: @grant ${funcname} in userscript metadata before using ${calling}`, TypeError);
  1067. }
  1068. }
  1069.  
  1070. function isObject(val) {
  1071. return typeof val === 'object' && val !== null;
  1072. }
  1073. }
  1074. }
  1075. class RedeclarationError extends TypeError {}
  1076. class CircularDependencyError extends ReferenceError {}
  1077.  
  1078.  
  1079. // 预置的函数池
  1080. const default_pool = new FuncPool();
  1081.  
  1082. /**
  1083. * 在预置的函数池中加载函数对象或其数组
  1084. * @param {oFunc[]|oFunc} oFuncs - 需要执行的函数对象
  1085. * @returns {FuncPool}
  1086. */
  1087. function loadFuncs(oFuncs) {
  1088. default_pool.load(oFuncs);
  1089. return default_pool;
  1090. }
  1091.  
  1092. /**
  1093. * 在预置的函数池中获取函数对象的返回值
  1094. * @param {string} id - 函数对象的字符串id
  1095. * @returns {*}
  1096. */
  1097. function require(id) {
  1098. return default_pool.require(id);
  1099. }
  1100.  
  1101. /**
  1102. * 在预置的函数池中检查指定函数对象是否已经加载完毕(有返回值可用)
  1103. * @param {string} id - 函数对象的字符串id
  1104. * @returns {boolean}
  1105. */
  1106. function isLoaded(id) {
  1107. return default_pool.isLoaded(id);
  1108. }
  1109.  
  1110. /**
  1111. * 测试给定checker是否检测通过
  1112. * 给定多个checker时,checkers之间是 或 关系,有一个checker通过即算作整体通过
  1113. * 注意此函数设计和旧版testChecker的设计不同,旧版中一个checker可以有多个值,还可通过checker.all指定多值之间的关系为 与 还是 或
  1114. * @param {checker[]|checker} [checkers] - 需要检测的checkers
  1115. * @returns {boolean}
  1116. */
  1117. function testCheckers(checkers=[]) {
  1118. checkers = Array.isArray(checkers) ? checkers : [checkers];
  1119. return checkers.length === 0 || checkers.some(checker => !!registered_checkers[checker.type]?.(checker.value));
  1120. }
  1121.  
  1122. /**
  1123. * 注册新checker
  1124. * 如果给定type已经被其他checker占用,则会报错RedeclarationError
  1125. * @param {string} type - checker类名
  1126. * @param {function} func - checker implementation
  1127. */
  1128. function registerChecker(type, func) {
  1129. if (registered_checkers.hasOwnProperty(type)) {
  1130. throw RedeclarationError(`Attempts to register checker with type already in use: ${type}`);
  1131. }
  1132. registered_checkers[type] = func;
  1133. }
  1134.  
  1135. const FunctionLoader = {
  1136. FuncPool,
  1137. testCheckers,
  1138. registerChecker,
  1139. get checkers() {
  1140. return Object.assign({}, registered_checkers);
  1141. },
  1142. Error: {
  1143. RedeclarationError,
  1144. CircularDependencyError
  1145. }
  1146. };
  1147. return [FunctionLoader, loadFuncs, require, isLoaded];
  1148. }) ();
  1149.  
  1150. return [
  1151. // Console & Debug
  1152. LogLevel, DoLog, Err, Assert,
  1153.  
  1154. // DOM
  1155. $, $All, $CrE, $AEL, $$CrE, addStyle, detectDom, destroyEvent,
  1156.  
  1157. // Data
  1158. copyProp, copyProps, parseArgs, escJsStr, replaceText,
  1159.  
  1160. // Environment & Browser
  1161. getUrlArgv, dl_browser, dl_GM,
  1162.  
  1163. // Logic & Task
  1164. AsyncManager, queueTask, FunctionLoader, loadFuncs, require, isLoaded
  1165. ];
  1166. }) ();