@browserless.io/browserless 2.37.1 → 2.38.0

package/CHANGELOG.md

@@ -1,6 +1,30 @@
-# [Latest](https://github.com/browserless/chrome/compare/v2.37.0...main)
+# [Latest](https://github.com/browserless/chrome/compare/v2.38.0...main)
+
+# [v2.38.0](https://github.com/browserless/chrome/compare/v2.37.1...v2.38.0)
+
+- Dependency updates.
+- Supports the following libraries and browsers:
+  - puppeteer-core: `24.26.1`
+  - playwright-core: `1.56.1`, `1.55.1`, `1.54.2`, `1.53.2`, and `1.52.0`.
+  - Chromium: `141.0.7390.37`
+  - Chrome: `141.0.7390.123` (amd64 only)
+  - Firefox: `142.0.1`
+  - Webkit: `26.0`
+  - Edge: `141.0.3537.99` (amd64 only)
+
+# [v2.37.1](https://github.com/browserless/chrome/compare/v2.37.1...v2.37.0)
 
 - Dependency updates.
+- Handling of `ignoreHTTPSErrors` to `acceptInsecureCerts`.
+- Smaller fixes, testing updates, and graceful shutdown handling.
+- Supports the following libraries and browsers:
+  - puppeteer-core: `24.23.0`
+  - playwright-core: `1.55.1`, `1.54.2`, `1.53.2`, `1.52.0`, and `1.51.1`.
+  - Chromium: `140.0.7339.16`
+  - Chrome: `141.0.7390.66` (amd64 only)
+  - Firefox: `141.0`
+  - Webkit: `26.0`
+  - Edge: `141.0.3537.57` (amd64 only)
 
 # [v2.37.0](https://github.com/browserless/chrome/compare/v2.36.0...v2.37.0)
 

package/extensions/ublocklite/_locales/ar/messages.json

@@ -264,15 +264,15 @@
     "description": "Short description for a checkbox in the options page"
   },
   "settingsBackupRestoreLabel": {
-    "message": "Backup",
+    "message": "النسخ الاحتياطي",
     "description": "The header text for the back up/restore section"
   },
   "settingsBackupRestoreSummary": {
-    "message": "Back up your custom settings to a file, or restore your custom settings from a file.",
+    "message": "قم بنسخ الإعدادات المخصصة احتياطيًا إلى ملف، أو استعادة الإعدادات المخصصة من ملف.",
     "description": "A summary description of the back up/restore section."
   },
   "settingsBackupRestoreLegend": {
-    "message": "Restoring will overwrite all your current custom settings.",
+    "message": "ستؤدي عملية الاستعادة إلى استبدال جميع إعداداتك المخصصة الحالية.",
     "description": "Important information about the back up/restore section."
   },
   "findListsPlaceholder": {
@@ -376,11 +376,11 @@
     "description": "Text for buttons used to export content"
   },
   "backupButton": {
-    "message": "Back up…",
+    "message": "نسخ احتياطي…",
     "description": "Text for buttons used to back up content"
   },
   "restoreButton": {
-    "message": "Restore…",
+    "message": "استعادة…",
     "description": "Text for buttons used to restore content"
   },
   "dnrRulesWarning": {

package/extensions/ublocklite/_locales/de/messages.json

@@ -264,7 +264,7 @@
     "description": "Short description for a checkbox in the options page"
   },
   "settingsBackupRestoreLabel": {
-    "message": "Sichern und wiederherstellen",
+    "message": "Sicherung",
     "description": "The header text for the back up/restore section"
   },
   "settingsBackupRestoreSummary": {

package/extensions/ublocklite/_locales/fa/messages.json

@@ -132,7 +132,7 @@
     "description": "First paragraph of 'Filter issues' section in Support pane"
   },
   "supportS5H": {
-    "message": "Troubleshooting information",
+    "message": "اطلاعات مشکل‌گشایی",
     "description": "Label of 'Troubleshooting information' section in 'Report a filter issue' page"
   },
   "supportS6P1S1": {
@@ -144,7 +144,7 @@
     "description": "A clickable link in the filter issue reporter section"
   },
   "supportS6URL": {
-    "message": "Address of the webpage:",
+    "message": "آدرس صفحه‌ی وب:",
     "description": "Label for the URL of the page"
   },
   "supportS6Select1": {
@@ -152,15 +152,15 @@
     "description": "Label for widget to select type of issue"
   },
   "supportS6Select1Option0": {
-    "message": "-- Pick an entry --",
+    "message": "-- یک گزینه را انتخاب کنید --",
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Select1Option1": {
-    "message": "Shows ads or ad leftovers",
+    "message": "تبلیغات یا باقی‌مانده‌هایی از آن نشان می‌دهد",
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Select1Option2": {
-    "message": "Has overlays or other nuisances",
+    "message": "دارای لایه‌های اضافی یا مشکلات مزاحم دیگر",
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Select1Option3": {
@@ -168,7 +168,7 @@
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Select1Option4": {
-    "message": "Has privacy-related issues",
+    "message": "دارای ایراد مربوط به حریم خصوصی است",
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Select1Option5": {
@@ -176,11 +176,11 @@
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Select1Option6": {
-    "message": "Opens unwanted tabs or windows",
+    "message": "تب یا پنجره‌ی ناخواسته باز می‌کند",
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Select1Option7": {
-    "message": "Leads to badware, phishing",
+    "message": "منجر به بدافزار یا فیشینگ می‌شود",
     "description": "An entry in the widget used to select the type of issue"
   },
   "supportS6Checkbox1": {

package/extensions/ublocklite/_locales/hu/messages.json

@@ -264,15 +264,15 @@
     "description": "Short description for a checkbox in the options page"
   },
   "settingsBackupRestoreLabel": {
-    "message": "Backup",
+    "message": "Biztonsági mentés",
     "description": "The header text for the back up/restore section"
   },
   "settingsBackupRestoreSummary": {
-    "message": "Back up your custom settings to a file, or restore your custom settings from a file.",
+    "message": "Egyéni beállítások fájlbamentése, vagy az egyéni beállítások helyreállítása egy fájlból.",
     "description": "A summary description of the back up/restore section."
   },
   "settingsBackupRestoreLegend": {
-    "message": "Restoring will overwrite all your current custom settings.",
+    "message": "A helyreállítás felülírja a jelenlegi egyéni beállításokat.",
     "description": "Important information about the back up/restore section."
   },
   "findListsPlaceholder": {
@@ -376,11 +376,11 @@
     "description": "Text for buttons used to export content"
   },
   "backupButton": {
-    "message": "Back up…",
+    "message": "Biztonsági mentés…",
     "description": "Text for buttons used to back up content"
   },
   "restoreButton": {
-    "message": "Restore…",
+    "message": "Helyreállítás…",
     "description": "Text for buttons used to restore content"
   },
   "dnrRulesWarning": {

package/extensions/ublocklite/_locales/nb/messages.json

@@ -44,7 +44,7 @@
     "description": "Label in the popup panel for the local tools section"
   },
   "popupTipReport": {
-    "message": "Rapporter et problem på dette nettstedet",
+    "message": "Rapporter et problem",
     "description": "Tooltip used for the 'chat' icon in the panel"
   },
   "popupTipDashboard": {
@@ -72,7 +72,7 @@
     "description": "Header for a ruleset section in 'Filter lists pane'"
   },
   "3pGroupMalware": {
-    "message": "Domener med skadelig programvare",
+    "message": "Beskyttelse mot skadelig programvare, sikkerhet",
     "description": "Header for a ruleset section in 'Filter lists pane'"
   },
   "3pGroupAnnoyances": {
@@ -264,15 +264,15 @@
     "description": "Short description for a checkbox in the options page"
   },
   "settingsBackupRestoreLabel": {
-    "message": "Backup",
+    "message": "Sikkerhetskopi",
     "description": "The header text for the back up/restore section"
   },
   "settingsBackupRestoreSummary": {
-    "message": "Back up your custom settings to a file, or restore your custom settings from a file.",
+    "message": "Sikkerhetskopier dine egendefinerte regler, eller gjenopprett dine egendefinerte regler fra en fil.",
     "description": "A summary description of the back up/restore section."
   },
   "settingsBackupRestoreLegend": {
-    "message": "Restoring will overwrite all your current custom settings.",
+    "message": "Gjenoppretting vil overskrive dine nåværende egendefinerte regler.",
     "description": "Important information about the back up/restore section."
   },
   "findListsPlaceholder": {
@@ -376,11 +376,11 @@
     "description": "Text for buttons used to export content"
   },
   "backupButton": {
-    "message": "Back up…",
+    "message": "Sikkerhetskopier…",
     "description": "Text for buttons used to back up content"
   },
   "restoreButton": {
-    "message": "Restore…",
+    "message": "Gjenopprett…",
     "description": "Text for buttons used to restore content"
   },
   "dnrRulesWarning": {

package/extensions/ublocklite/_locales/pt_PT/messages.json

@@ -20,7 +20,7 @@
     "description": "appears as tab name in dashboard"
   },
   "customFiltersPageName": {
-    "message": "Custom filters",
+    "message": "Filtros personalizados",
     "description": "appears as tab name in dashboard"
   },
   "developPageName": {
@@ -88,11 +88,11 @@
     "description": "Header for a ruleset section in 'Filter lists pane'"
   },
   "customFiltersImportExportLabel": {
-    "message": "Import / Export",
+    "message": "Importar / Exportar",
     "description": "Text label heading the import/export area of custom filters"
   },
   "customFiltersImportTextareaPlaceholder": {
-    "message": "Paste here specific cosmetic filters to add",
+    "message": "Cole aqui filtros cosméticos específicos a adicionar",
     "description": "Placeholder text which describes the purpose of the textarea widget"
   },
   "aboutChangelog": {
@@ -264,15 +264,15 @@
     "description": "Short description for a checkbox in the options page"
   },
   "settingsBackupRestoreLabel": {
-    "message": "Backup",
+    "message": "Cópia de segurança",
     "description": "The header text for the back up/restore section"
   },
   "settingsBackupRestoreSummary": {
-    "message": "Back up your custom settings to a file, or restore your custom settings from a file.",
+    "message": "Faça uma cópia de segurança das suas definições personalizadas num ficheiro ou restaure as suas definições personalizadas a partir de um ficheiro.",
     "description": "A summary description of the back up/restore section."
   },
   "settingsBackupRestoreLegend": {
-    "message": "Restoring will overwrite all your current custom settings.",
+    "message": "A restauração substituirá todas as suas definições personalizadas atuais.",
     "description": "Important information about the back up/restore section."
   },
   "findListsPlaceholder": {
@@ -364,7 +364,7 @@
     "description": "Text for buttons used to revert changes"
   },
   "addButton": {
-    "message": "Add",
+    "message": "Adicionar",
     "description": "Text for buttons used to add content"
   },
   "importAndAppendButton": {
@@ -376,11 +376,11 @@
     "description": "Text for buttons used to export content"
   },
   "backupButton": {
-    "message": "Back up…",
+    "message": "Criar cópia…",
     "description": "Text for buttons used to back up content"
   },
   "restoreButton": {
-    "message": "Restore…",
+    "message": "Restaurar…",
     "description": "Text for buttons used to restore content"
   },
   "dnrRulesWarning": {

package/extensions/ublocklite/_locales/ro/messages.json

@@ -20,11 +20,11 @@
     "description": "appears as tab name in dashboard"
   },
   "customFiltersPageName": {
-    "message": "Custom filters",
+    "message": "Filtre proprii",
     "description": "appears as tab name in dashboard"
   },
   "developPageName": {
-    "message": "Develop",
+    "message": "Dezvoltă",
     "description": "appears as tab name in dashboard. Inspired from 'Develop' menu in Safari, see https://developer.apple.com/documentation/safari-developer-tools/develop-menu"
   },
   "aboutPageName": {
@@ -40,7 +40,7 @@
     "description": "Label in the popup panel for the current filtering mode"
   },
   "popupLocalToolsLabel": {
-    "message": "On this website",
+    "message": "Pe acest website",
     "description": "Label in the popup panel for the local tools section"
   },
   "popupTipReport": {
@@ -88,11 +88,11 @@
     "description": "Header for a ruleset section in 'Filter lists pane'"
   },
   "customFiltersImportExportLabel": {
-    "message": "Import / Export",
+    "message": "Importă / Exportă",
     "description": "Text label heading the import/export area of custom filters"
   },
   "customFiltersImportTextareaPlaceholder": {
-    "message": "Paste here specific cosmetic filters to add",
+    "message": "Lipește aici filtre cosmetice specifice",
     "description": "Placeholder text which describes the purpose of the textarea widget"
   },
   "aboutChangelog": {
@@ -132,7 +132,7 @@
     "description": "First paragraph of 'Filter issues' section in Support pane"
   },
   "supportS5H": {
-    "message": "Troubleshooting information",
+    "message": "Informații depanare",
     "description": "Label of 'Troubleshooting information' section in 'Report a filter issue' page"
   },
   "supportS6P1S1": {
@@ -256,11 +256,11 @@
     "description": "Short description for a checkbox in the options page"
   },
   "developerModeLabel": {
-    "message": "Developer mode",
+    "message": "Mod dezvoltator",
     "description": "Label for a checkbox in the options page"
   },
   "developerModeLegend": {
-    "message": "Enables access to features suitable for technical users.",
+    "message": "Permite accesul la funcții adecvate pentru utilizatorii tehnici.",
     "description": "Short description for a checkbox in the options page"
   },
   "settingsBackupRestoreLabel": {
@@ -268,11 +268,11 @@
     "description": "The header text for the back up/restore section"
   },
   "settingsBackupRestoreSummary": {
-    "message": "Back up your custom settings to a file, or restore your custom settings from a file.",
+    "message": "Copiați setările personalizate într-un fișier sau restaurați setările personalizate dintr-un fișier.",
     "description": "A summary description of the back up/restore section."
   },
   "settingsBackupRestoreLegend": {
-    "message": "Restoring will overwrite all your current custom settings.",
+    "message": "Restaurarea va suprascrie toate setările personalizate actuale.",
     "description": "Important information about the back up/restore section."
   },
   "findListsPlaceholder": {
@@ -316,63 +316,63 @@
     "description": "A button to navigate to the blocked page"
   },
   "zapperTipEnter": {
-    "message": "Remove an element",
+    "message": "Elimina unui element",
     "description": "Tooltip for the button used to enter zapper mode"
   },
   "zapperTipQuit": {
-    "message": "Exit element zapper mode",
+    "message": "Ieșire din modul zapper element",
     "description": "Tooltip for the button used to exit zapper mode"
   },
   "pickerTipEnter": {
-    "message": "Create a custom filter",
+    "message": "Creați un filtru personalizat",
     "description": "Label for the menu entry to create cosmetic filters"
   },
   "unpickerTipEnter": {
-    "message": "Remove a custom filter",
+    "message": "Șterge un filtru personalizat",
     "description": "Label for the menu entry to delete cosmetic filters"
   },
   "developDropdownLabel": {
-    "message": "View:",
+    "message": "Vezi:",
     "description": "A label of a dropdown list"
   },
   "developOptionFilteringModeDetails": {
-    "message": "Filtering mode details",
+    "message": "Detalii privind modul de filtrare",
     "description": "An option in a dropdown list"
   },
   "developOptionCustomDnrRules": {
-    "message": "Custom DNR rules",
+    "message": "Reguli DNR personalizate",
     "description": "An option in a dropdown list"
   },
   "developOptionDnrRulesOf": {
-    "message": "DNR rules of …",
+    "message": "Regulile DNR privind …",
     "description": "A section header in a dropdown list"
   },
   "developOptionDynamicRuleset": {
-    "message": "Dynamic ruleset",
+    "message": "Set de reguli dinamice",
     "description": "An option in a dropdown list"
   },
   "developOptionSessionRuleset": {
-    "message": "Session ruleset",
+    "message": "Set de reguli pentru sesiune",
     "description": "An option in a dropdown list"
   },
   "saveButton": {
-    "message": "Save",
+    "message": "Salvați",
     "description": "Text for buttons used to save changes"
   },
   "revertButton": {
-    "message": "Revert",
+    "message": "Reveniţi",
     "description": "Text for buttons used to revert changes"
   },
   "addButton": {
-    "message": "Add",
+    "message": "Adaugă",
     "description": "Text for buttons used to add content"
   },
   "importAndAppendButton": {
-    "message": "Import and append…",
+    "message": "Importați și adăugați…",
     "description": "Text for buttons used to import and append content"
   },
   "exportButton": {
-    "message": "Export…",
+    "message": "Exportă…",
     "description": "Text for buttons used to export content"
   },
   "backupButton": {
@@ -380,31 +380,31 @@
     "description": "Text for buttons used to back up content"
   },
   "restoreButton": {
-    "message": "Restore…",
+    "message": "Restaurați…",
     "description": "Text for buttons used to restore content"
   },
   "dnrRulesWarning": {
-    "message": "Do not add content from untrusted sources",
+    "message": "Nu adăugați conținut din surse nesigure",
     "description": "Short description of the DNR rules editor pane"
   },
   "dnrRulesCountInfo": {
-    "message": "Number of registered rules: {count}",
+    "message": "Număr de reguli înregistrate: {count}",
     "description": "Short sentence to report the number of currently registered DNR rules"
   },
   "pickerSliderLabel": {
-    "message": "Move the slider to select the best match",
+    "message": "Mutați cursorul pentru a selecta cea mai bună potrivire",
     "description": "Label to describe the purpose of the slider"
   },
   "pickerPick": {
-    "message": "Pick",
+    "message": "Alege",
     "description": "Text for the button to re-enter element-picking mode"
   },
   "pickerPreview": {
-    "message": "Preview",
+    "message": "Previzualizare",
     "description": "Text for the button to activate preview mode"
   },
   "pickerCreate": {
-    "message": "Create",
+    "message": "Creează",
     "description": "Text for the button to create the filter"
   },
   "unpickerUsage": {

package/extensions/ublocklite/_locales/sq/messages.json

@@ -264,15 +264,15 @@
     "description": "Short description for a checkbox in the options page"
   },
   "settingsBackupRestoreLabel": {
-    "message": "Rezervoj",
+    "message": "Kopja rezervë",
     "description": "The header text for the back up/restore section"
   },
   "settingsBackupRestoreSummary": {
-    "message": "Krijoni kopje rezervë të parametrave të personalizuara në një skedar ose restauroni parametrat e personalizuara nga një skedar.",
+    "message": "Mbani një kopje rezervë të parametrave që keni personalizuar ose riktheni parametrat e mëparshëm.",
     "description": "A summary description of the back up/restore section."
   },
   "settingsBackupRestoreLegend": {
-    "message": "Restaurimi do të mbishkruajë të gjitha parametrat tuaja aktuale të personalizuara.",
+    "message": "Rikthimi do të fshijë gjithë parametrat që keni personalizuar.",
     "description": "Important information about the back up/restore section."
   },
   "findListsPlaceholder": {
@@ -380,7 +380,7 @@
     "description": "Text for buttons used to back up content"
   },
   "restoreButton": {
-    "message": "Rivendos…",
+    "message": "Rikthej…",
     "description": "Text for buttons used to restore content"
   },
   "dnrRulesWarning": {

package/extensions/ublocklite/js/background.js

@@ -154,6 +154,17 @@ async function onPermissionsAdded(permissions) {
     }
 }
 
+async function onPermissionsChanged(op, permissions) {
+    await isFullyInitialized;
+    const { pending } = onPermissionsChanged;
+    await Promise.all(pending);
+    const promise = op === 'removed'
+        ? onPermissionsRemoved()
+        : onPermissionsAdded(permissions);
+    pending.push(promise);
+}
+onPermissionsChanged.pending = [];
+
 /******************************************************************************/
 
 function setDeveloperMode(state) {
@@ -337,6 +348,12 @@ function onMessage(request, sender, callback) {
         });
         return true;
 
+    case 'hasBroadHostPermissions':
+        hasBroadHostPermissions().then(result => {
+            callback(result);
+        });
+        return true;
+
     case 'setAutoReload':
         rulesetConfig.autoReload = request.state && true || false;
         saveRulesetConfig().then(( ) => {
@@ -692,13 +709,13 @@ runtime.onMessage.addListener((request, sender, callback) => {
 
 browser.permissions.onRemoved.addListener((...args) => {
     isFullyInitialized.then(( ) => {
-        onPermissionsRemoved(...args);
+        onPermissionsChanged('removed', ...args);
     });
 });
 
 browser.permissions.onAdded.addListener((...args) => {
     isFullyInitialized.then(( ) => {
-        onPermissionsAdded(...args);
+        onPermissionsChanged('added', ...args);
     });
 });
 

package/extensions/ublocklite/js/mode-manager.js

@@ -365,17 +365,15 @@ export async function syncWithBrowserPermissions() {
     if ( afterMode > MODE_BASIC ) { return afterMode !== beforeMode; }
     const filteringModes = await getFilteringModeDetails();
     if ( allowedHostnames.has('all-urls') === false ) {
-        const { optimal, complete } = filteringModes;
-        for ( const hn of optimal ) {
-            if ( allowedHostnames.has(hn) ) { continue; }
-            if ( isDescendantHostnameOfIter(hn, allowedHostnames) ) { continue; }
-            optimal.delete(hn);
+        const { none, basic, optimal, complete } = filteringModes;
+        for ( const hn of new Set([ ...optimal, ...complete ]) ) {
+            applyFilteringMode(filteringModes, hn, afterMode);
             modified = true;
         }
-        for ( const hn of complete ) {
-            if ( allowedHostnames.has(hn) ) { continue; }
-            if ( isDescendantHostnameOfIter(hn, allowedHostnames) ) { continue; }
-            complete.delete(hn);
+        for ( const hn of allowedHostnames ) {
+            if ( optimal.has(hn) || complete.has(hn) ) { continue; }
+            if ( basic.has(hn) || none.has(hn) ) { continue; }
+            applyFilteringMode(filteringModes, hn, MODE_OPTIMAL);
             modified = true;
         }
         if ( modified ) {

package/extensions/ublocklite/js/scripting/css-api.js

@@ -0,0 +1,33 @@
+/*******************************************************************************
+
+    uBlock Origin Lite - a comprehensive, MV3-compliant content blocker
+    Copyright (C) 2025-present Raymond Hill
+
+    This program is free software: you can redistribute it and/or modify
+    it under the terms of the GNU General Public License as published by
+    the Free Software Foundation, either version 3 of the License, or
+    (at your option) any later version.
+
+    This program is distributed in the hope that it will be useful,
+    but WITHOUT ANY WARRANTY; without even the implied warranty of
+    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+    GNU General Public License for more details.
+
+    You should have received a copy of the GNU General Public License
+    along with this program.  If not, see {http://www.gnu.org/licenses/}.
+
+    Home: https://github.com/gorhill/uBlock
+*/
+
+(api => {
+    if ( typeof api === 'object' ) { return; }
+    self.cssAPI = {
+        insert(css) {
+            chrome.runtime.sendMessage({
+                what: 'insertCSS',
+                css,
+            }).catch(( ) => {
+            });
+        },
+    };
+})(self.cssAPI);

package/extensions/ublocklite/js/scripting/css-generic.js

@@ -61,7 +61,7 @@ const hashFromStr = (type, s) => {
     for ( let i = 0; i < len; i += step ) {
         hash = (hash << 5) + hash ^ s.charCodeAt(i);
     }
-    return hash & 0xFFFFFF;
+    return hash & 0xFFF;
 };
 
 /******************************************************************************/
@@ -188,7 +188,7 @@ const uBOL_processNodes = ( ) => {
     if ( styleSheetTimer !== undefined ) { return; }
     styleSheetTimer = self.requestAnimationFrame(( ) => {
         styleSheetTimer = undefined;
-        uBOL_injectCSS(`${styleSheetSelectors.join(',')}{display:none!important;}`);
+        self.cssAPI.insert(`${styleSheetSelectors.join(',')}{display:none!important;}`);
         styleSheetSelectors.length = 0;
     });
 };
@@ -214,17 +214,7 @@ const uBOL_processChanges = mutations => {
 
 /******************************************************************************/
 
-const uBOL_injectCSS = css => {
-    chrome.runtime.sendMessage({
-        what: 'insertCSS',
-        css,
-    }).catch(( ) => {
-    });
-};
-
-/******************************************************************************/
-
-const stopAll = reason => {
+const stopAll = ( ) => {
     if ( domChangeTimer !== undefined ) {
         self.clearTimeout(domChangeTimer);
         domChangeTimer = undefined;