☰

Word and Text Replace

Replaces text with other text.

  1. // ==UserScript==
  2. // @name         Word and Text Replace
  3. // @namespace    https://github.com/erickRecai
  4. // @version      1.05.03
  5. // @description  Replaces text with other text.
  6. // @author       guyRicky
  7.  
  8. // @match        *://*/*
  9. // @noframes
  10.  
  11. // @exclude      *://docs.google.com/*
  12. // @exclude      *://drive.google.com/*
  13. // @exclude      *://mail.google.com/*
  14.  
  15. // @require      https://code.jquery.com/jquery-3.4.1.min.js
  16. // @require      https://greasyfork.org/scripts/381859-waitforkeyelements-by-brocka/code/WaitForKeyElements%20by%20BrockA.js?version=689364
  17.  
  18. // @licence      CC-BY-NC-SA-4.0; https://creativecommons.org/licenses/by-nc-sa/4.0/
  19. // @licence      GPL-3.0-or-later; http://www.gnu.org/licenses/gpl-3.0.txt
  20. // ==/UserScript==
  21. /* jshint esversion: 6 */
  22.  
  23. (function () {
  24.     'use strict';
  25.  
  26.     if(0){/*
  27. last update: 7/04/2020
  28.  
  29. == todo ==
  30. 1. comment on iframes.
  31. 1. script execution flow with FHD.
  32. 1. separate counter for each execution instance.
  33.  
  34. 10. case: 2 text nodes have the same parent block.
  35.  
  36. == issues ==
  37. - certain text nodes aren't accessed with markCheckedElement enabled. (multiple text nodes)
  38.  
  39. == how it works ==
  40. 1a. calls processPage() once for each major run.
  41. 1b. creates list of specific text nodes then checks each against all rules.
  42. 1ba. with special replace enabled, if delete or full replace match, check stops after the first special match.
  43. - this excludes elements previously checked.
  44. - changes text based on matches.
  45. 1c. after checking a text node against all rules, applies a 'checked' class to the element containing the text node.
  46.  
  47. 2a. dlt1 and dlt2 completely replaces text by default, option to change.
  48.  
  49. == notification notes ==
  50. 1e. elements checked by title attributes are processed in a separate block.
  51. 5a. notifications only work for those sites enabled with filters.
  52.  
  53. == version history ==
  54. == 1.05.03 ==
  55. - custom execution time
  56. - some clean up.
  57.  
  58. == code markers ==
  59. AA. initial setup
  60. AB. replace rules
  61. AC. special rules
  62. BA. script options
  63. BB. notif code block
  64. CA. processPage()
  65. CB. execution control
  66. DA. script button
  67. DB. support functions
  68.     */}
  69.     
  70.     // ==== AA. initial setup =====================================================================|
  71.  
  72.     const scriptPrefix = "rplt-";
  73.     const scriptTag = "RPLT";
  74.  
  75.     let runScript = 1;
  76.     runScript = getOptionState("enable-"+ scriptPrefix +"script", runScript);
  77.  
  78.     if (runScript) {
  79.  
  80.         let enableConsoleMessages = 1; // default 0; set to 1 to show console messages.
  81.         enableConsoleMessages = getOptionState("log-"+ scriptPrefix +"msg", enableConsoleMessages);
  82.  
  83.         let enabledMessages =
  84.             //"MA|"+ // any rule matches
  85.             "TT-MA|"+ // page title match.
  86.             "TXT-MA|"+ // all text matches.
  87.             "DLT1|"+ // delete1 matches.
  88.             "DLT2|"+ // delete2 matches
  89.             "FR1|"+ // full replace matches.
  90.             //"CH-TT|"+ // changed text.
  91.  
  92.             "RUNT|"+ // runtime messages (amount of time to execute)
  93.             "EXEC|"+ // execution messages (when code is executed)
  94.             "\\bST\\b|"+ //script option change update
  95.             "GEN$|"+ // general messages
  96.             "^1"; // high priority messages
  97.         let logAll = 0; // if 1, logs all titles from blocks.
  98.         logAll = getOptionState("log-"+ scriptPrefix +"all", logAll);
  99.         if (logAll) {
  100.             enabledMessages = enabledMessages.concat("|title");
  101.         }
  102.         const enabledMessagesRegex = new RegExp(enabledMessages); // used in consolelog().
  103.  
  104.         consolelog("#### ("+ scriptTag +") text replace script began. ####", "EXEC");
  105.  
  106.         // ==== AB. replace rules =================================================================|
  107.  
  108.         let replaceRules = [
  109.             //[//i, ""], // rule template
  110.     
  111.             // basic examples:
  112.             //[/commit/i, "dog"],
  113.             //[/branch/i, "turtle"],
  114.             //[/file/i, "birdie"],
  115.             //[/\w/g, "a"], //replaces all characters with "a".
  116.             //[/(.|\W)+/i, "text"], //replaces all text instances with "text".
  117.         ];
  118.  
  119.         // ==== AC. special rules =================================================================|
  120.  
  121.         const enableSpecialRules = 1;
  122.         if (enableSpecialRules) {
  123.             // example of including a rule list defined in a spearate script.
  124.             if (unsafeWindow.globalListName) {
  125.                 replaceRules = replaceRules.concat(unsafeWindow.globalListName);
  126.             }
  127.         }
  128.         //consolelog(replaceRules,"all rules"); //test: double check rule contents
  129.  
  130.         // ==== BA. script options ================================================================|
  131.  
  132.         const classWhitelist = /notif-hidden|notif-text|tag-inst|-counter/i;
  133.         // text nodes with parent elements with these classes are excluded.
  134.  
  135.         const generateRecheckButton = 1;
  136.  
  137.         let dynamicChecking = 1; // default 1; set to 1 to run the script automatically when new image elements are detected.
  138.         dynamicChecking = getOptionState("enable-"+ scriptPrefix +"dynamic-checking", dynamicChecking);
  139.         // setting to 0 would make this run a few more times when dynamically checking.
  140.         
  141.         // ==== checked in processPage() ====
  142.         // managable with optional Script Options userscript.
  143.         let logRuntimes = 1; // default 0; set to 1 to log function runtimes to the console.
  144.         let markCheckedElements = 1; // default 1; set to 0 if certain sites start appearing weirdly.
  145.  
  146.         let enableSpecialReplace = 1;
  147.         let fullDelete = 0; // default 1; if 1, text is completely replaced.
  148.         let addTag = 1; // if fullDelete is active, adds a tag without replacing.
  149.  
  150.         // ==== BB. notif code ====================================================================|
  151.  
  152.         // 'script options' options
  153.         let enableExecCounter = 0;
  154.         enableExecCounter = getOptionState("enable-"+ scriptPrefix +"counter", enableExecCounter);
  155.         let enableNotifications = 0;
  156.         enableNotifications = getOptionState("enable-"+ scriptPrefix +"notifs", enableNotifications);
  157.         let autohideNotifs = 0; // default 0; notifs disappear after a set period of time. used in createNotif()
  158.         let startCollapsed = 1; //default 1;
  159.  
  160.         // notif css variables.
  161.         const notifsHex = "#ddd";
  162.         const notifsOpacity = .4; // default .4; set to a value between 0 and 1, 1 is no transparency, .5 is 50% transparency.
  163.         const notifsWidth = 120; // default 120; width in pixels of each notification.
  164.  
  165.         let notifContainerId = "notif-main-container";
  166.  
  167.         // generate notif container if needed.
  168.         if ((enableExecCounter || enableNotifications) && !jQuery("#"+ notifContainerId).length) {
  169.  
  170.             // ==== setting/checking initial visual state of notifs ====
  171.  
  172.             // constrolled exclusively by local storage or the default value.
  173.             const localStorageName = "notif start collapsed";
  174.             if (window.localStorage.getItem(localStorageName)) {
  175.                 startCollapsed = window.localStorage.getItem(localStorageName);
  176.                 startCollapsed = (startCollapsed == "true");
  177.             }
  178.  
  179.             const visibleClass = "notif-visible";
  180.             const hiddenClass = "notif-hidden1";
  181.             let startingStateClass = visibleClass;
  182.             let otherStartingStateClass = hiddenClass;
  183.             if (startCollapsed) {
  184.                 startingStateClass = hiddenClass;
  185.                 otherStartingStateClass = visibleClass;
  186.             }
  187.  
  188.             // ==== create container ==============================================================|
  189.             /*
  190.             [ notif main container
  191.                 [notif1] - counters
  192.                 [hide] - button
  193.                 [open] - button
  194.                 [close] - button
  195.                 [clear] - button
  196.                 [notif2
  197.                     [dlt-container]
  198.                     [ll-container]
  199.                     [ot-container]
  200.                 ]
  201.  
  202.             ]
  203.             - hide: makes visible open | hides close, clear, notif2
  204.             - open: makes visible hide, close, clear, notif2 | hides open
  205.             - close: deletes notif main container.
  206.             - clear: empties notif-container2
  207.             */
  208.  
  209.             const openButtonId = "notif-open";
  210.             const hideButtonId = "notif-hide";
  211.  
  212.             let notificationsElement =
  213.                 "<div id='"+ notifContainerId +"'>"+
  214.                 "<div id='notif-container1'></div>"+
  215.                 "<div id='"+ hideButtonId +"' class='notif-red notif-rounded-block "+ startingStateClass +"'>notif hide</div>"+
  216.                 "<div id='"+ openButtonId +"' class='notif-green notif-rounded-block "+ otherStartingStateClass +"'>notif open</div>"+
  217.                 "<div id='notif-close' class='notif-gray notif-rounded-block "+ startingStateClass +"'>close notif[]</div>"+
  218.                 "<div id='notif-clear' class='notif-orange notif-rounded-block "+ startingStateClass +"'>clear notif</div>"+
  219.                 "<div id='notif-container2' class=' "+ startingStateClass +"'>"+
  220.                     "<div id='dlt-container'></div>"+
  221.                     "<div id='ll-container' class='notif-hidden1'></div>"+
  222.                     "<div id='ot-container' class='notif-hidden1'</div>"+
  223.                 "</div>"+
  224.                 "</div>";
  225.             jQuery("body").prepend(notificationsElement);
  226.  
  227.             let textReaderElement =
  228.                 "<div id='notif-text-overlay' class='notif-text-hidden'></div>";
  229.             jQuery("body").prepend(textReaderElement);
  230.  
  231.             jQuery('#notif-container2').on( {
  232.                 mouseenter: function () {
  233.                     let notifText = jQuery(this).find(".notif-text").text();
  234.                     let notifClassList = this.className;
  235.                     if (/red/.test(notifClassList)) {
  236.                         jQuery("#notif-text-overlay").addClass("notif-red");
  237.                     }else if (/orange/.test(notifClassList)) {
  238.                         jQuery("#notif-text-overlay").addClass("notif-orange");
  239.                     }else if (/yellow/.test(notifClassList)) {
  240.                         jQuery("#notif-text-overlay").addClass("notif-yellow");
  241.                     }else {
  242.                         jQuery("#notif-text-overlay").addClass("notif-gray");
  243.                     }
  244.                     jQuery("#notif-text-overlay").text(notifText);
  245.                     jQuery("#notif-text-overlay").addClass("notif-text-visible");
  246.                 },
  247.                 mouseleave: function () {
  248.                     jQuery("#notif-text-overlay").removeClass("notif-text-visible");
  249.                     jQuery("#notif-text-overlay").removeClass("notif-red");
  250.                     jQuery("#notif-text-overlay").removeClass("notif-orange");
  251.                 }
  252.             }, '.notif-instance');
  253.  
  254.             // ==== close ====
  255.             jQuery("#notif-close").click(function(){
  256.                 jQuery("#"+notifContainerId).remove();
  257.                 //console.log("RPL notif close clicked. ("+notifContainerId+")");
  258.             });
  259.  
  260.             // ==== clears container2 which contains notif instances. ====
  261.             function clearNotif(){
  262.                 jQuery("#notif-container2").empty();
  263.             }
  264.             jQuery("#notif-clear").click(clearNotif);
  265.  
  266.             // ==== open/hide events ==============================================================|
  267.  
  268.             const mainSelector = "#notif-container2, #"+ hideButtonId +", #notif-close, #notif-clear";
  269.  
  270.             jQuery("#"+ hideButtonId).click(function () {
  271.                 //console.log(hideButtonId);
  272.                 window.localStorage.setItem(localStorageName, true);
  273.  
  274.                 switchClasses(
  275.                     mainSelector,
  276.                     "#"+ openButtonId,
  277.                     visibleClass,
  278.                     hiddenClass
  279.                 );
  280.             });
  281.  
  282.             jQuery("#"+ openButtonId).click(function () {
  283.                 //console.log(openButtonId);
  284.                 window.localStorage.setItem(localStorageName, false);
  285.  
  286.                 switchClasses(
  287.                     mainSelector,
  288.                     "#"+ openButtonId,
  289.                     hiddenClass,
  290.                     visibleClass
  291.                 );
  292.             });
  293.  
  294.             function switchClasses(mainSelector, subSelector, removedClass, newClass) {
  295.                 jQuery(mainSelector).removeClass(removedClass);
  296.                 jQuery(mainSelector).addClass(newClass);
  297.                 jQuery(subSelector).removeClass(newClass);
  298.                 jQuery(subSelector).addClass(removedClass);
  299.             }
  300.  
  301.             // ==== CSS ===========================================================================|
  302.             if(1){var notifsCss =
  303.     `<style type="text/css">
  304.         #`+ notifContainerId +` {
  305.             width: `+ notifsWidth +`px;
  306.             max-height: 50%;
  307.             margin: 0 2px 2px;
  308.             display: block;
  309.  
  310.             line-height: initial;
  311.             color: #000;
  312.             opacity: `+ notifsOpacity +`;
  313.             position: fixed;
  314.             top: 0px;
  315.             right: 0px;
  316.             z-index: 9999;
  317.             overflow-y: auto;
  318.         }
  319.         #`+ notifContainerId +`:hover {
  320.             opacity: 1;
  321.         }
  322.  
  323.         .notif-rounded-block {
  324.             display: block;
  325.             padding: 2px;
  326.             border-radius: 3px;
  327.             margin-top: 2px;
  328.  
  329.             font-size: 11px !important;
  330.             font-weight: bold;
  331.             text-align: center;
  332.             cursor: pointer;
  333.         }
  334.  
  335.         .s-counter {
  336.             display: block;
  337.             padding: 2px;
  338.             border-radius: 4px;
  339.             margin-top: 2px;
  340.  
  341.             background: #ddd;
  342.             font-size: 11px !important;
  343.             font-weight: bold;
  344.             text-align: center;
  345.         }
  346.  
  347.         .notif-text-hidden {
  348.             display:none;
  349.         }
  350.         .notif-text-visible {
  351.             display: block;
  352.             max-width: 50%;
  353.             padding: 5px;
  354.             border: #999 solid 2px;
  355.             border-radius: 10px;
  356.  
  357.             position: fixed;
  358.             top: 5px;
  359.             left: 5px;
  360.             z-index: 999999;
  361.  
  362.  
  363.             font-size: 15px !important;
  364.             font-weight: bold !important;
  365.             text-align: center !important;
  366.             color: black !important;
  367.         }
  368.  
  369.         .notif-instance {
  370.             display: block;
  371.             padding: 2px;
  372.             border-radius: 4px;
  373.             margin-top: 2px;
  374.  
  375.             background: `+ notifsHex +`;
  376.             font-size: 11px !important;
  377.             font-weight: bold;
  378.             text-align: center;
  379.             cursor: pointer;
  380.         }
  381.  
  382.         .notif-instance div{/* div holding the rule.*/
  383.             max-height: 12px;
  384.             padding: 0px;
  385.             margin: 0px;
  386.             border: 0px;
  387.  
  388.             overflow: hidden;
  389.             word-break: break-all;
  390.         }
  391.         .notif-hidden{ /* meant to hide the rule */
  392.             opacity: .1;
  393.         }
  394.         .notif-hidden:hover {
  395.             opacity: 1;
  396.         }
  397.  
  398.         .notif-red {
  399.             background: #f67066;
  400.         }
  401.         .notif-orange {
  402.             background: #ffc107; //yellowish
  403.         }
  404.         .notif-yellow {
  405.             background: #ffc107; //yellowish
  406.         }
  407.         .notif-green {
  408.             background: #62bb66;
  409.         }
  410.         .notif-gray {
  411.             background: #777;
  412.         }
  413.  
  414.         /* collapsible classes */
  415.         .notif-hidden1 {
  416.             display: none !important;
  417.         }
  418.         .notif-visible {
  419.             display: block !important;
  420.         }
  421.  
  422.         div#ll-container, div#ot-container {
  423.             border-top: solid black 3px;
  424.         }
  425.     </style>`;
  426.             }
  427.             jQuery(document.body).append(notifsCss);
  428.         }
  429.  
  430.         if(enableExecCounter) {
  431.             jQuery("#notif-container1").prepend("<div id='"+ scriptTag +"-counter' class='s-counter .notif-rounded-block'>T No text nodes found.</div>");
  432.         }
  433.  
  434.         // resets lastIndex on tests with global modifiers.
  435.         RegExp.prototype.regexTest = function(testString){
  436.             //consolelog("## regexTest() ##", 1);
  437.             if (this.test(testString)) {
  438.                 if (/.\/i?g/.test(this) && this.lastIndex) {//regex global modifier needs to be reset.
  439.                     //consolelog("## last index: "+ this.lastIndex +" ##", 1);
  440.                     this.lastIndex = 0;
  441.                 }
  442.                 return true;
  443.             }
  444.             return false;
  445.         };
  446.  
  447.         NodeList.prototype.forEach = Array.prototype.forEach;
  448.         
  449.         // ==== CA. processPage() =================================================================|
  450.  
  451.         // ==== processPage() globals ====
  452.         let titleChecked = 0; // if the page title was checked or not.
  453.         let fullCheck = 0;
  454.  
  455.         // ==== counters ====
  456.         let nodeCounter = 0; // counts text nodes.
  457.         let deleteMatches = 0;
  458.         let fullReplaceMatches = 0;
  459.         let executionCounter = 0; // the number of times processPage() was executed.
  460.  
  461.         function processPage() {
  462.             executionCounter++;
  463.  
  464.             logRuntimes = getOptionState("log-"+ scriptPrefix +"runtimes", logRuntimes);
  465.             if (logRuntimes) {
  466.                 var startTime = performance.now();
  467.             }
  468.  
  469.             let rulesNum = replaceRules.length;
  470.  
  471.             // per element variables
  472.             let ruleMatched = 0;
  473.  
  474.             // ==== checks the title of the page ==================================================|
  475.             if(1){
  476.                 let titleText = jQuery("title").text();
  477.                 if (titleText && !titleChecked) {
  478.                     for (let index = 0; index < rulesNum; index++) {
  479.                         if (replaceRules[index][0].regexTest(titleText)) {
  480.                             consolelog(scriptTag +" (title match): "+ titleText +" | "+ replaceRules[index][0], "TT-MA");
  481.                             titleText = titleText.replace(replaceRules[index][0], replaceRules[index][1]);
  482.                             jQuery("title").text(titleText);
  483.                         }
  484.                     }
  485.                     titleChecked = 1;
  486.                 }
  487.             }
  488.  
  489.             // ==== selects specified text elements ===============================================|
  490.             if(1){
  491.                 const excludedElements = /CODE|SCRIPT|STYLE|TEXTAREA/i;
  492.                 const checkClassRegex = new RegExp(scriptPrefix +"node","i");
  493.                 var textWalker = document.createTreeWalker(
  494.                     document.body,
  495.                     NodeFilter.SHOW_TEXT,
  496.                     {
  497.                         acceptNode: function (node) {
  498.                             if (node.nodeValue.trim() &&
  499.                                 !excludedElements.test(node.parentNode.nodeName) && // exclude scripts and style elements
  500.                                 (fullCheck || !checkClassRegex.test(node.parentNode.classList)) && // exclude checked elements
  501.                                 !classWhitelist.test(node.parentNode.classList)) {
  502.                                 return NodeFilter.FILTER_ACCEPT;
  503.                             }
  504.                             return NodeFilter.FILTER_SKIP;
  505.                         }
  506.                     },
  507.                     false
  508.                 );
  509.             }
  510.             let textNode = textWalker.nextNode();
  511.  
  512.             // ==== for each textNode =============================================================|
  513.             while (textNode) {
  514.  
  515.                 let nodeText = textNode.nodeValue; // is changed based on matches.
  516.                 if (!fullCheck) {
  517.                     let immediateParentNode = textNode.parentNode; // element containing the text node.
  518.                     nodeCounter++;
  519.                     
  520.                     markCheckedElements = getOptionState(scriptPrefix +"mark-checked", markCheckedElements);
  521.                     if (markCheckedElements) {
  522.                         immediateParentNode.classList.add(scriptPrefix +"node-"+ nodeCounter); //prefix
  523.                     }
  524.                 }
  525.  
  526.                 // ==== for each rule =============================================================|
  527.                 for (let index = 0; index < rulesNum; index++) {
  528.  
  529.                     let currentRuleRegex = replaceRules[index][0];
  530.                     let replacementValue = replaceRules[index][1];
  531.  
  532.                     if (currentRuleRegex.regexTest(nodeText.trim())) {
  533.                         ruleMatched = 1;
  534.                         let matchPrefix = "GEN0";
  535.                         consolelog("("+ scriptTag +") (n)"+ nodeCounter +" (match): "+ nodeText.trim() +" | "+ currentRuleRegex, "TXT-MA");
  536.  
  537.                         const disableReplace = 0; // test: check what is checked through each run.
  538.                         if (!disableReplace) {
  539.                             
  540.                             enableSpecialReplace = getOptionState("enable-special-replace", enableSpecialReplace);
  541.                             // ==== delete1 match =================================================|
  542.                             if (enableSpecialReplace && (/DELETE1/.test(replacementValue) || /DELETE2/.test(replacementValue)) ) {
  543.                                 deleteMatches++;
  544.  
  545.                                 matchPrefix = "DLT99";
  546.                                 if (/DELETE1/.test(replacementValue) && !/DELETE1/.test(nodeText)) {
  547.                                     matchPrefix = "DLT1";
  548.                                 }else if (/DELETE2/.test(replacementValue) && !/DELETE2/.test(nodeText)) {
  549.                                     matchPrefix = "DLT2";
  550.                                 }
  551.                                 
  552.                                 consolelog("("+ scriptTag +") ("+ matchPrefix +") n"+ nodeCounter +" (match): "+ nodeText.trim() +" | "+ currentRuleRegex, matchPrefix);
  553.                                 createNotif(nodeCounter +" "+ matchPrefix, currentRuleRegex, nodeText);
  554.  
  555.                                 fullDelete = getOptionState("enable-full-delete", fullDelete);
  556.                                 addTag = getOptionState("add-tag", addTag);
  557.                                 const tagRegex = new RegExp("^\\["+matchPrefix);
  558.  
  559.                                 if (fullDelete) {
  560.                                     nodeText = "## "+ matchPrefix +" ##"; // replaces the text completely.
  561.                                     break;
  562.                                 }else if (addTag && !tagRegex.text(nodeText)) {
  563.                                     nodeText = "["+ matchPrefix +"]: " + nodeText; // prepends DLT1 or DLT2
  564.                                 }
  565.                             }
  566.                             // ==== full replace match ============================================|
  567.                             if (enableSpecialReplace && /^FR1/.test(replacementValue)) {
  568.                                 fullReplaceMatches++;
  569.                                 matchPrefix = "FR1";
  570.                                 consolelog("("+ scriptTag +") ("+ matchPrefix +") n"+ nodeCounter +" (match): "+ nodeText.trim() +" | "+ currentRuleRegex, matchPrefix);
  571.                                 createNotif(nodeCounter +" "+ matchPrefix, currentRuleRegex, nodeText);
  572.  
  573.                                 nodeText = replacementValue;
  574.                                 break;
  575.                             }
  576.                             // ==== base case =====================================================|
  577.                             nodeText = nodeText.replace(currentRuleRegex, replacementValue);
  578.                         } // end if (!disableReplace)
  579.                     }
  580.                 } // end for (each rule) ==========================================================|
  581.  
  582.                 if (ruleMatched) { // modify text block.
  583.                     ruleMatched = 0;
  584.                     textNode.nodeValue = nodeText;
  585.                     consolelog("("+ scriptTag +") (n)"+ nodeCounter +" (text): "+ nodeText.trim(), "CH-TT");
  586.                 }
  587.                 textNode = textWalker.nextNode();
  588.             } // end while (textNode) =============================================================|
  589.  
  590.             if (!fullCheck) {
  591.                 // ==== update counter ====
  592.                 let counterText = "T DLT:"+ deleteMatches +" | FR:"+ fullReplaceMatches +" | N:"+ nodeCounter + " | EX:"+ executionCounter;
  593.                 jQuery("#"+ scriptTag +"-counter").text(counterText);
  594.                 if (nodeCounter) {
  595.                     jQuery("#"+ scriptTag +"-counter").addClass("notif-green");
  596.                 }
  597.             }else { //end fullCheck.
  598.                 fullCheck = 0;
  599.             }
  600.  
  601.             //consolelog("## ("+ scriptTag +") execution #"+ executionCounter +" ##", "EXEC");
  602.             // script option handles if this is displayed or not.
  603.             if (logRuntimes) {
  604.                 const endTime = performance.now();
  605.                 const runTime = ((endTime - startTime) / 1000).toFixed(2);
  606.                 if (runTime > 1) {
  607.                     consolelog('('+ scriptTag +') finished after ' + runTime + ' seconds.', "RUNT");
  608.                 }else {
  609.                     consolelog('('+ scriptTag +') finished in less than 1 second.', "RUNT");
  610.                 }
  611.             }
  612.         } //end function function replaceText()
  613.  
  614.         // ==== CB. execution control =============================================================|
  615.         
  616.         //console.log("("+ scriptTag +") EXEC: Initial run.");
  617.         //processPage();
  618.         let runWhenReady = 0;
  619.         runWhenReady = getOptionState("run-when-ready", runWhenReady);
  620.         if (runWhenReady) {
  621.             jQuery(document).ready(function() { //after DOM has loaded.
  622.                 consolelog("("+ scriptTag +") EXEC: document.ready()", "EXEC");
  623.                 //fullCheck = 1;
  624.                 processPage();
  625.             });
  626.         }
  627.  
  628.         let runWhenLoaded = 1;
  629.         runWhenLoaded = getOptionState("run-when-loaded", runWhenLoaded);
  630.         if (runWhenLoaded) {
  631.             jQuery(window).on("load", function() { //after all initial images are loaded.
  632.                 consolelog("("+ scriptTag +") EXEC: window.load()", "EXEC");
  633.                 //fullCheck = 1;
  634.                 processPage();
  635.             });
  636.         }
  637.         if (dynamicChecking) {
  638.             jQuery(document).ready(waitForKeyElements("img", processPage));
  639.         }
  640.  
  641.         // ==== DA. script button =================================================================|
  642.  
  643.         let buttonsContainerId = "ctb-container1";
  644.         if (generateRecheckButton && jQuery("#"+ buttonsContainerId).length) {
  645.             jQuery("#"+ buttonsContainerId).prepend("<div id='"+ scriptTag +"-reset' class='ctb-blue ctb-rounded-block'>run "+ scriptTag +"</div>"); //added to beginning
  646.             //jQuery("#"+ scriptTag +"-reset").click(processPage);
  647.             jQuery("#"+ scriptTag +"-reset").click(function() {
  648.                 fullCheck = 1;
  649.                 processPage();
  650.             });
  651.         }
  652.  
  653.         // ==== DB. support functions =============================================================|
  654.  
  655.         function createNotif(notifLabel, notifRule, notifText) { //msg1 needs to match notifTypes
  656.             enableNotifications = getOptionState("enable-"+ scriptPrefix +"notifs", enableNotifications);
  657.             if (enableNotifications) {
  658.                 let additionalClass = "notif-gray";
  659.                 let notifContainer = "ot-container";
  660.                 if (/dlt/i.test(notifLabel)) {
  661.                     additionalClass = "notif-red";
  662.                     notifContainer = "dlt-container";
  663.                 }
  664.  
  665.                 let newNotif =
  666.                     "<div class='notif-instance "+ additionalClass +"'><div>t n"+ notifLabel +"</div>"+
  667.                         "<div class='notif-hidden'>"+ notifRule +"</div>"+
  668.                         "<div class='notif-text' hidden>"+ notifText+"</div>"+ // to be displayed at the bottom left.
  669.                     "</div>";
  670.  
  671.                 let enabledNotifTypesRegex = /./;
  672.                 if (enabledNotifTypesRegex.test(notifLabel)) {
  673.                     jQuery("#"+ notifContainer).append(newNotif);
  674.                     jQuery(".notif-instance").click(function(){
  675.                         jQuery("#notif-container2").empty();
  676.                     });
  677.  
  678.                     if (!/dlt/i.test(notifLabel)) {
  679.                         jQuery("#ot-container").removeClass("notif-hidden1");
  680.                     }
  681.  
  682.                     autohideNotifs = getOptionState("autohide-notifications", autohideNotifs);
  683.                     if (autohideNotifs) {
  684.                         const notifDuration = 10; // default 10; amount of seconds notifications are displayed before disappearing.
  685.                         setTimeout(function() {
  686.                             jQuery(".notif-instance").remove();
  687.                         }, notifDuration*1000);
  688.                     }
  689.                 }
  690.             }
  691.         } // end function creatNotif()
  692.  
  693.         function consolelog(text, messageType) {
  694.             if (enableConsoleMessages && enabledMessagesRegex.test(messageType)) {
  695.                 console.log(text);
  696.             }
  697.         }
  698.  
  699.         // ==== script end ========================================================================|
  700.         consolelog("#### ("+ scriptTag +") text replace script is active. ####", "EXEC");
  701.  
  702.     } // end if (runScript)
  703.  
  704.     // ============================================================================================|
  705.  
  706.     // = getOptionState(, );
  707.     // used to update option if 'script option' is set.
  708.     function getOptionState(idName, currentState) {
  709.         if (document.getElementById(idName)) {
  710.             return document.getElementById(idName).checked;
  711.         }
  712.         return currentState;
  713.     }
  714. })();