☰

Brazen Item Attributes Resolver

Item attributes resolution helper class

当前为 2023-01-17 提交的版本，查看 最新版本。

此脚本不应直接安装。它是供其他脚本使用的外部库，要使用该库请加入元指令 // @require https://update.cn-greasyfork.org/scripts/429587/1139392/Brazen%20Item%20Attributes%20Resolver.js 

  1. // ==UserScript==
  2. // @name         Brazen Item Attributes Resolver
  3. // @namespace    brazenvoid
  4. // @version      2.2.1
  5. // @author       brazenvoid
  6. // @license      GPL-3.0-only
  7. // @description  Item attributes resolution helper class
  8. // ==/UserScript==
  9.  
  10. class BrazenItemAttributesResolver
  11. {
  12.     /**
  13.      * @typedef {{itemLinkSelector: JQuery.Selector, itemDeepAnalysisSelector: JQuery.Selector, requestDelay: number,
  14.      *            onDeepAttributesResolution: Function}} ItemAttributesResolverConfiguration
  15.      */
  16.     
  17.     /**
  18.      * @callback ItemAttributesResolverCallback
  19.      * @param {JQuery} item
  20.      * @return {*}
  21.      */
  22.     
  23.     /**
  24.      * @param {ItemAttributesResolverConfiguration} configuration
  25.      */
  26.     constructor(configuration)
  27.     {
  28.         /**
  29.          * @type {{}}
  30.          * @private
  31.          */
  32.         this._attributes = {}
  33.         
  34.         /**
  35.          * @type {{}}
  36.          * @private
  37.          */
  38.         this._deepAttributes = {}
  39.         
  40.         /**
  41.          * @type {boolean}
  42.          * @private
  43.          */
  44.         this._hasDeepAttributes = false
  45.         
  46.         /**
  47.          * @type {JQuery.Selector}
  48.          * @protected
  49.          */
  50.         this._itemLinkSelector = configuration.itemLinkSelector
  51.         
  52.         /**
  53.          * @type {JQuery.Selector}
  54.          * @protected
  55.          */
  56.         this._itemDeepAnalysisSelector = configuration.itemDeepAnalysisSelector
  57.         
  58.         /**
  59.          * @type {Function}
  60.          * @private
  61.          */
  62.         this._onDeepAttributesResolution = configuration.onDeepAttributesResolution
  63.         
  64.         /**
  65.          * @type {number}
  66.          * @private
  67.          */
  68.         this._requestDelay = configuration.requestDelay
  69.         
  70.         /**
  71.          * @type {number}
  72.          * @private
  73.          */
  74.         this._requestIteration = 1
  75.         
  76.         /**
  77.          * @type {JQuery<HTMLElement> | jQuery | HTMLElement}
  78.          * @private
  79.          */
  80.         this._sandbox = $('<div id="brazen-item-attributes-resolver-sandbox" hidden/>').appendTo('body')
  81.     }
  82.     
  83.     /**
  84.      * @param {string} attribute
  85.      * @returns {string}
  86.      * @private
  87.      */
  88.     _formatAttributeName(attribute)
  89.     {
  90.         return attribute.toLowerCase().replaceAll(' ', '_')
  91.     }
  92.     
  93.     /**
  94.      * @param {JQuery} item
  95.      * @param {Object} attributesBag
  96.      * @private
  97.      */
  98.     _loadDeepAttributes(item, attributesBag)
  99.     {
  100.         let url = item.find(this._itemLinkSelector).attr('href')
  101.         if (url) {
  102.             Utilities.sleep(this._requestIteration * this._requestDelay).then(() => {
  103.                 try {
  104.                     this._sandbox.load(url + ' ' + this._itemDeepAnalysisSelector, () => {
  105.                         for (const attributeName in this._deepAttributes) {
  106.                             attributesBag[attributeName] = this._deepAttributes[attributeName](this._sandbox)
  107.                         }
  108.                         this._onDeepAttributesResolution(item)
  109.                         this._sandbox.empty()
  110.                     })
  111.                 } catch (error) {
  112.                     console.error('Deep attributes loading failed.')
  113.                 }
  114.             })
  115.             this._requestIteration++
  116.         }
  117.     }
  118.     
  119.     /**
  120.      * @param {string} attribute
  121.      * @param {ItemAttributesResolverCallback} resolutionCallback
  122.      * @returns {this}
  123.      */
  124.     addAttribute(attribute, resolutionCallback)
  125.     {
  126.         this._attributes[this._formatAttributeName(attribute)] = resolutionCallback
  127.         return this
  128.     }
  129.     
  130.     /**
  131.      * @param {string} attribute
  132.      * @param {ItemAttributesResolverCallback} resolutionCallback
  133.      * @returns {this}
  134.      */
  135.     addDeepAttribute(attribute, resolutionCallback)
  136.     {
  137.         this._deepAttributes[this._formatAttributeName(attribute)] = resolutionCallback
  138.         this._hasDeepAttributes = true
  139.         return this
  140.     }
  141.     
  142.     /**
  143.      * @returns {BrazenItemAttributesResolver}
  144.      */
  145.     completeResolutionRun()
  146.     {
  147.         this._requestIteration = 1
  148.         return this
  149.     }
  150.     
  151.     /**
  152.      * @param {JQuery} item
  153.      * @param {string} attribute
  154.      * @returns {*}
  155.      */
  156.     get(item, attribute)
  157.     {
  158.         let attributesBag = item[0].scriptAttributes
  159.         if (typeof attributesBag !== 'undefined') {
  160.             let attributeName = this._formatAttributeName(attribute)
  161.             let attributeValue = attributesBag[attributeName]
  162.             if (typeof attributeValue !== 'undefined') {
  163.                 return attributeValue
  164.             } else if (this._hasDeepAttributes) {
  165.                 this._loadDeepAttributes(item, attributesBag)
  166.             }
  167.         }
  168.         return null
  169.     }
  170.     
  171.     /**
  172.      * @param {JQuery} item
  173.      * @param {Function|null} afterResolutionCallback
  174.      */
  175.     resolveAttributes(item, afterResolutionCallback = null)
  176.     {
  177.         let attributesBag = {}
  178.         item[0].scriptAttributes = attributesBag
  179.         
  180.         for (const attributeName in this._attributes) {
  181.             attributesBag[attributeName] = this._attributes[attributeName](item)
  182.         }
  183.     }
  184.     
  185.     /**
  186.      * @param {JQuery} item
  187.      * @param {string} attribute
  188.      * @param {*} value
  189.      * @returns {BrazenItemAttributesResolver}
  190.      */
  191.     set(item, attribute, value)
  192.     {
  193.         item[0].scriptAttributes[this._formatAttributeName(attribute)] = value
  194.         return this
  195.     }
  196. }