chrome-devtools-mcp 0.0.1 → 0.0.2

package/build/node_modules/chrome-devtools-frontend/front_end/core/common/Settings.js

@@ -0,0 +1,1281 @@
+// Copyright 2009 The Chromium Authors
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+import * as Platform from '../platform/platform.js';
+import * as Root from '../root/root.js';
+import { Console } from './Console.js';
+import { ObjectWrapper } from './Object.js';
+import { getLocalizedSettingsCategory, getRegisteredSettings as getRegisteredSettingsInternal, maybeRemoveSettingExtension, registerSettingExtension, registerSettingsForTest, resetSettings, } from './SettingRegistration.js';
+let settingsInstance;
+export class Settings {
+    syncedStorage;
+    globalStorage;
+    localStorage;
+    #sessionStorage = new SettingsStorage({});
+    settingNameSet = new Set();
+    orderValuesBySettingCategory = new Map();
+    #eventSupport = new ObjectWrapper();
+    #registry = new Map();
+    moduleSettings = new Map();
+    #logSettingAccess;
+    constructor(syncedStorage, globalStorage, localStorage, logSettingAccess) {
+        this.syncedStorage = syncedStorage;
+        this.globalStorage = globalStorage;
+        this.localStorage = localStorage;
+        this.#logSettingAccess = logSettingAccess;
+        for (const registration of this.getRegisteredSettings()) {
+            const { settingName, defaultValue, storageType } = registration;
+            const isRegex = registration.settingType === "regex" /* SettingType.REGEX */;
+            const evaluatedDefaultValue = typeof defaultValue === 'function' ? defaultValue(Root.Runtime.hostConfig) : defaultValue;
+            const setting = isRegex && typeof evaluatedDefaultValue === 'string' ?
+                this.createRegExpSetting(settingName, evaluatedDefaultValue, undefined, storageType) :
+                this.createSetting(settingName, evaluatedDefaultValue, storageType);
+            setting.setTitleFunction(registration.title);
+            if (registration.userActionCondition) {
+                setting.setRequiresUserAction(Boolean(Root.Runtime.Runtime.queryParam(registration.userActionCondition)));
+            }
+            setting.setRegistration(registration);
+            this.registerModuleSetting(setting);
+        }
+    }
+    getRegisteredSettings() {
+        return getRegisteredSettingsInternal();
+    }
+    static hasInstance() {
+        return typeof settingsInstance !== 'undefined';
+    }
+    static instance(opts = { forceNew: null, syncedStorage: null, globalStorage: null, localStorage: null }) {
+        const { forceNew, syncedStorage, globalStorage, localStorage, logSettingAccess } = opts;
+        if (!settingsInstance || forceNew) {
+            if (!syncedStorage || !globalStorage || !localStorage) {
+                throw new Error(`Unable to create settings: global and local storage must be provided: ${new Error().stack}`);
+            }
+            settingsInstance = new Settings(syncedStorage, globalStorage, localStorage, logSettingAccess);
+        }
+        return settingsInstance;
+    }
+    static removeInstance() {
+        settingsInstance = undefined;
+    }
+    registerModuleSetting(setting) {
+        const settingName = setting.name;
+        const category = setting.category();
+        const order = setting.order();
+        if (this.settingNameSet.has(settingName)) {
+            throw new Error(`Duplicate Setting name '${settingName}'`);
+        }
+        if (category && order) {
+            const orderValues = this.orderValuesBySettingCategory.get(category) || new Set();
+            if (orderValues.has(order)) {
+                throw new Error(`Duplicate order value '${order}' for settings category '${category}'`);
+            }
+            orderValues.add(order);
+            this.orderValuesBySettingCategory.set(category, orderValues);
+        }
+        this.settingNameSet.add(settingName);
+        this.moduleSettings.set(setting.name, setting);
+    }
+    static normalizeSettingName(name) {
+        if ([
+            VersionController.GLOBAL_VERSION_SETTING_NAME,
+            VersionController.SYNCED_VERSION_SETTING_NAME,
+            VersionController.LOCAL_VERSION_SETTING_NAME,
+            'currentDockState',
+            'isUnderTest',
+        ].includes(name)) {
+            return name;
+        }
+        return Platform.StringUtilities.toKebabCase(name);
+    }
+    /**
+     * Prefer a module setting if this setting is one that you might not want to
+     * surface to the user to control themselves. Examples of these are settings
+     * to store UI state such as how a user choses to position a split widget or
+     * which panel they last opened.
+     * If you are creating a setting that you expect the user to control, and
+     * sync, prefer {@see createSetting}
+     */
+    // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    moduleSetting(settingName) {
+        const setting = this.moduleSettings.get(settingName);
+        if (!setting) {
+            throw new Error('No setting registered: ' + settingName);
+        }
+        return setting;
+    }
+    settingForTest(settingName) {
+        const setting = this.#registry.get(settingName);
+        if (!setting) {
+            throw new Error('No setting registered: ' + settingName);
+        }
+        return setting;
+    }
+    /**
+     * Get setting via key, and create a new setting if the requested setting does not exist.
+     * @param key kebab-case string ID
+     * @param defaultValue
+     * @param storageType If not specified, SettingStorageType.GLOBAL is used.
+     */
+    createSetting(key, defaultValue, storageType) {
+        const storage = this.storageFromType(storageType);
+        let setting = this.#registry.get(key);
+        if (!setting) {
+            setting = new Setting(key, defaultValue, this.#eventSupport, storage, this.#logSettingAccess);
+            this.#registry.set(key, setting);
+        }
+        return setting;
+    }
+    createLocalSetting(key, defaultValue) {
+        return this.createSetting(key, defaultValue, "Local" /* SettingStorageType.LOCAL */);
+    }
+    createRegExpSetting(key, defaultValue, regexFlags, storageType) {
+        if (!this.#registry.get(key)) {
+            this.#registry.set(key, new RegExpSetting(key, defaultValue, this.#eventSupport, this.storageFromType(storageType), regexFlags, this.#logSettingAccess));
+        }
+        return this.#registry.get(key);
+    }
+    clearAll() {
+        this.globalStorage.removeAll();
+        this.syncedStorage.removeAll();
+        this.localStorage.removeAll();
+        new VersionController().resetToCurrent();
+    }
+    storageFromType(storageType) {
+        switch (storageType) {
+            case "Local" /* SettingStorageType.LOCAL */:
+                return this.localStorage;
+            case "Session" /* SettingStorageType.SESSION */:
+                return this.#sessionStorage;
+            case "Global" /* SettingStorageType.GLOBAL */:
+                return this.globalStorage;
+            case "Synced" /* SettingStorageType.SYNCED */:
+                return this.syncedStorage;
+        }
+        return this.globalStorage;
+    }
+    getRegistry() {
+        return this.#registry;
+    }
+}
+export const NOOP_STORAGE = {
+    register: () => { },
+    set: () => { },
+    get: () => Promise.resolve(''),
+    remove: () => { },
+    clear: () => { },
+};
+export class SettingsStorage {
+    object;
+    backingStore;
+    storagePrefix;
+    constructor(object, backingStore = NOOP_STORAGE, storagePrefix = '') {
+        this.object = object;
+        this.backingStore = backingStore;
+        this.storagePrefix = storagePrefix;
+    }
+    register(name) {
+        name = this.storagePrefix + name;
+        this.backingStore.register(name);
+    }
+    set(name, value) {
+        name = this.storagePrefix + name;
+        this.object[name] = value;
+        this.backingStore.set(name, value);
+    }
+    has(name) {
+        name = this.storagePrefix + name;
+        return name in this.object;
+    }
+    get(name) {
+        name = this.storagePrefix + name;
+        return this.object[name];
+    }
+    async forceGet(originalName) {
+        const name = this.storagePrefix + originalName;
+        const value = await this.backingStore.get(name);
+        if (value && value !== this.object[name]) {
+            this.set(originalName, value);
+        }
+        else if (!value) {
+            this.remove(originalName);
+        }
+        return value;
+    }
+    remove(name) {
+        name = this.storagePrefix + name;
+        delete this.object[name];
+        this.backingStore.remove(name);
+    }
+    removeAll() {
+        this.object = {};
+        this.backingStore.clear();
+    }
+    keys() {
+        return Object.keys(this.object);
+    }
+    dumpSizes() {
+        Console.instance().log('Ten largest settings: ');
+        // @ts-expect-error __proto__ optimization
+        const sizes = { __proto__: null };
+        for (const key in this.object) {
+            sizes[key] = this.object[key].length;
+        }
+        const keys = Object.keys(sizes);
+        function comparator(key1, key2) {
+            return sizes[key2] - sizes[key1];
+        }
+        keys.sort(comparator);
+        for (let i = 0; i < 10 && i < keys.length; ++i) {
+            Console.instance().log('Setting: \'' + keys[i] + '\', size: ' + sizes[keys[i]]);
+        }
+    }
+}
+function removeSetting(setting) {
+    const name = setting.name;
+    const settings = Settings.instance();
+    settings.getRegistry().delete(name);
+    settings.moduleSettings.delete(name);
+    setting.storage.remove(name);
+}
+export class Deprecation {
+    disabled;
+    warning;
+    experiment;
+    constructor({ deprecationNotice }) {
+        if (!deprecationNotice) {
+            throw new Error('Cannot create deprecation info for a non-deprecated setting');
+        }
+        this.disabled = deprecationNotice.disabled;
+        this.warning = deprecationNotice.warning();
+        this.experiment = deprecationNotice.experiment ?
+            Root.Runtime.experiments.allConfigurableExperiments().find(e => e.name === deprecationNotice.experiment) :
+            undefined;
+    }
+}
+export class Setting {
+    name;
+    defaultValue;
+    eventSupport;
+    storage;
+    #titleFunction;
+    #title;
+    #registration = null;
+    #requiresUserAction;
+    #value;
+    // TODO(crbug.com/1172300) Type cannot be inferred without changes to consumers. See above.
+    #serializer = JSON;
+    #hadUserAction;
+    #disabled;
+    #deprecation = null;
+    #loggedInitialAccess = false;
+    #logSettingAccess;
+    constructor(name, defaultValue, eventSupport, storage, logSettingAccess) {
+        this.name = name;
+        this.defaultValue = defaultValue;
+        this.eventSupport = eventSupport;
+        this.storage = storage;
+        storage.register(this.name);
+        this.#logSettingAccess = logSettingAccess;
+    }
+    setSerializer(serializer) {
+        this.#serializer = serializer;
+    }
+    addChangeListener(listener, thisObject) {
+        return this.eventSupport.addEventListener(this.name, listener, thisObject);
+    }
+    removeChangeListener(listener, thisObject) {
+        this.eventSupport.removeEventListener(this.name, listener, thisObject);
+    }
+    title() {
+        if (this.#title) {
+            return this.#title;
+        }
+        if (this.#titleFunction) {
+            return this.#titleFunction();
+        }
+        return '';
+    }
+    setTitleFunction(titleFunction) {
+        if (titleFunction) {
+            this.#titleFunction = titleFunction;
+        }
+    }
+    setTitle(title) {
+        this.#title = title;
+    }
+    setRequiresUserAction(requiresUserAction) {
+        this.#requiresUserAction = requiresUserAction;
+    }
+    disabled() {
+        if (this.#registration?.disabledCondition) {
+            const { disabled } = this.#registration.disabledCondition(Root.Runtime.hostConfig);
+            // If registration does not disable it, pass through to #disabled
+            // attribute check.
+            if (disabled) {
+                return true;
+            }
+        }
+        return this.#disabled || false;
+    }
+    disabledReasons() {
+        if (this.#registration?.disabledCondition) {
+            const result = this.#registration.disabledCondition(Root.Runtime.hostConfig);
+            if (result.disabled) {
+                return result.reasons;
+            }
+        }
+        return [];
+    }
+    setDisabled(disabled) {
+        this.#disabled = disabled;
+        this.eventSupport.dispatchEventToListeners(this.name);
+    }
+    #maybeLogAccess(value) {
+        try {
+            const valueToLog = typeof value === 'string' || typeof value === 'number' || typeof value === 'boolean' ?
+                value :
+                this.#serializer?.stringify(value);
+            if (valueToLog !== undefined && this.#logSettingAccess) {
+                void this.#logSettingAccess(this.name, valueToLog);
+            }
+        }
+        catch {
+        }
+    }
+    #maybeLogInitialAccess(value) {
+        if (!this.#loggedInitialAccess) {
+            this.#maybeLogAccess(value);
+            this.#loggedInitialAccess = true;
+        }
+    }
+    get() {
+        if (this.#requiresUserAction && !this.#hadUserAction) {
+            this.#maybeLogInitialAccess(this.defaultValue);
+            return this.defaultValue;
+        }
+        if (typeof this.#value !== 'undefined') {
+            this.#maybeLogInitialAccess(this.#value);
+            return this.#value;
+        }
+        this.#value = this.defaultValue;
+        if (this.storage.has(this.name)) {
+            try {
+                this.#value = this.#serializer.parse(this.storage.get(this.name));
+            }
+            catch {
+                this.storage.remove(this.name);
+            }
+        }
+        this.#maybeLogInitialAccess(this.#value);
+        return this.#value;
+    }
+    // Prefer this getter for settings which are "disableable". The plain getter returns `this.#value`,
+    // even if the setting is disabled, which means the callsite has to explicitly call the `disabled()`
+    // getter and add its own logic for the disabled state.
+    getIfNotDisabled() {
+        if (this.disabled()) {
+            return;
+        }
+        return this.get();
+    }
+    async forceGet() {
+        const name = this.name;
+        const oldValue = this.storage.get(name);
+        const value = await this.storage.forceGet(name);
+        this.#value = this.defaultValue;
+        if (value) {
+            try {
+                this.#value = this.#serializer.parse(value);
+            }
+            catch {
+                this.storage.remove(this.name);
+            }
+        }
+        if (oldValue !== value) {
+            this.eventSupport.dispatchEventToListeners(this.name, this.#value);
+        }
+        this.#maybeLogInitialAccess(this.#value);
+        return this.#value;
+    }
+    set(value) {
+        this.#maybeLogAccess(value);
+        this.#hadUserAction = true;
+        this.#value = value;
+        try {
+            const settingString = this.#serializer.stringify(value);
+            try {
+                this.storage.set(this.name, settingString);
+            }
+            catch (e) {
+                this.printSettingsSavingError(e.message, settingString);
+            }
+        }
+        catch (e) {
+            Console.instance().error('Cannot stringify setting with name: ' + this.name + ', error: ' + e.message);
+        }
+        this.eventSupport.dispatchEventToListeners(this.name, value);
+    }
+    setRegistration(registration) {
+        this.#registration = registration;
+        const { deprecationNotice } = registration;
+        if (deprecationNotice?.disabled) {
+            const experiment = deprecationNotice.experiment ?
+                Root.Runtime.experiments.allConfigurableExperiments().find(e => e.name === deprecationNotice.experiment) :
+                undefined;
+            if ((!experiment || experiment.isEnabled())) {
+                this.set(this.defaultValue);
+                this.setDisabled(true);
+            }
+        }
+    }
+    type() {
+        if (this.#registration) {
+            return this.#registration.settingType;
+        }
+        return null;
+    }
+    options() {
+        if (this.#registration && this.#registration.options) {
+            return this.#registration.options.map(opt => {
+                const { value, title, text, raw } = opt;
+                return {
+                    value,
+                    title: title(),
+                    text: typeof text === 'function' ? text() : text,
+                    raw,
+                };
+            });
+        }
+        return [];
+    }
+    reloadRequired() {
+        if (this.#registration) {
+            return this.#registration.reloadRequired || null;
+        }
+        return null;
+    }
+    category() {
+        if (this.#registration) {
+            return this.#registration.category || null;
+        }
+        return null;
+    }
+    tags() {
+        if (this.#registration && this.#registration.tags) {
+            // Get localized keys and separate by null character to prevent fuzzy matching from matching across them.
+            return this.#registration.tags.map(tag => tag()).join('\0');
+        }
+        return null;
+    }
+    order() {
+        if (this.#registration) {
+            return this.#registration.order || null;
+        }
+        return null;
+    }
+    learnMore() {
+        return this.#registration?.learnMore ?? null;
+    }
+    get deprecation() {
+        if (!this.#registration || !this.#registration.deprecationNotice) {
+            return null;
+        }
+        if (!this.#deprecation) {
+            this.#deprecation = new Deprecation(this.#registration);
+        }
+        return this.#deprecation;
+    }
+    printSettingsSavingError(message, value) {
+        const errorMessage = 'Error saving setting with name: ' + this.name + ', value length: ' + value.length + '. Error: ' + message;
+        console.error(errorMessage);
+        Console.instance().error(errorMessage);
+        this.storage.dumpSizes();
+    }
+}
+// TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export class RegExpSetting extends Setting {
+    #regexFlags;
+    #regex;
+    constructor(name, defaultValue, eventSupport, storage, regexFlags, logSettingAccess) {
+        super(name, defaultValue ? [{ pattern: defaultValue }] : [], eventSupport, storage, logSettingAccess);
+        this.#regexFlags = regexFlags;
+    }
+    get() {
+        const result = [];
+        const items = this.getAsArray();
+        for (let i = 0; i < items.length; ++i) {
+            const item = items[i];
+            if (item.pattern && !item.disabled) {
+                result.push(item.pattern);
+            }
+        }
+        return result.join('|');
+    }
+    getAsArray() {
+        return super.get();
+    }
+    set(value) {
+        this.setAsArray([{ pattern: value, disabled: false }]);
+    }
+    setAsArray(value) {
+        this.#regex = undefined;
+        super.set(value);
+    }
+    asRegExp() {
+        if (typeof this.#regex !== 'undefined') {
+            return this.#regex;
+        }
+        this.#regex = null;
+        try {
+            const pattern = this.get();
+            if (pattern) {
+                this.#regex = new RegExp(pattern, this.#regexFlags || '');
+            }
+        }
+        catch {
+        }
+        return this.#regex;
+    }
+}
+export class VersionController {
+    static GLOBAL_VERSION_SETTING_NAME = 'inspectorVersion';
+    static SYNCED_VERSION_SETTING_NAME = 'syncedInspectorVersion';
+    static LOCAL_VERSION_SETTING_NAME = 'localInspectorVersion';
+    static CURRENT_VERSION = 40;
+    #globalVersionSetting;
+    #syncedVersionSetting;
+    #localVersionSetting;
+    constructor() {
+        // If no version setting is found, we initialize with the current version and don't do anything.
+        this.#globalVersionSetting = Settings.instance().createSetting(VersionController.GLOBAL_VERSION_SETTING_NAME, VersionController.CURRENT_VERSION, "Global" /* SettingStorageType.GLOBAL */);
+        this.#syncedVersionSetting = Settings.instance().createSetting(VersionController.SYNCED_VERSION_SETTING_NAME, VersionController.CURRENT_VERSION, "Synced" /* SettingStorageType.SYNCED */);
+        this.#localVersionSetting = Settings.instance().createSetting(VersionController.LOCAL_VERSION_SETTING_NAME, VersionController.CURRENT_VERSION, "Local" /* SettingStorageType.LOCAL */);
+    }
+    /**
+     * Force re-sets all version number settings to the current version without
+     * running any migrations.
+     */
+    resetToCurrent() {
+        this.#globalVersionSetting.set(VersionController.CURRENT_VERSION);
+        this.#syncedVersionSetting.set(VersionController.CURRENT_VERSION);
+        this.#localVersionSetting.set(VersionController.CURRENT_VERSION);
+    }
+    /**
+     * Runs the appropriate migrations and updates the version settings accordingly.
+     *
+     * To determine what migrations to run we take the minimum of all version number settings.
+     *
+     * IMPORTANT: All migrations must be idempotent since they might be applied multiple times.
+     */
+    updateVersion() {
+        const currentVersion = VersionController.CURRENT_VERSION;
+        const minimumVersion = Math.min(this.#globalVersionSetting.get(), this.#syncedVersionSetting.get(), this.#localVersionSetting.get());
+        const methodsToRun = this.methodsToRunToUpdateVersion(minimumVersion, currentVersion);
+        console.assert(
+        // @ts-expect-error
+        this[`updateVersionFrom${currentVersion}To${currentVersion + 1}`] === undefined, 'Unexpected migration method found. Increment CURRENT_VERSION or remove the method.');
+        for (const method of methodsToRun) {
+            // @ts-expect-error Special version method matching
+            this[method].call(this);
+        }
+        this.resetToCurrent();
+    }
+    methodsToRunToUpdateVersion(oldVersion, currentVersion) {
+        const result = [];
+        for (let i = oldVersion; i < currentVersion; ++i) {
+            result.push('updateVersionFrom' + i + 'To' + (i + 1));
+        }
+        return result;
+    }
+    updateVersionFrom0To1() {
+        this.clearBreakpointsWhenTooMany(Settings.instance().createLocalSetting('breakpoints', []), 500000);
+    }
+    updateVersionFrom1To2() {
+        Settings.instance().createSetting('previouslyViewedFiles', []).set([]);
+    }
+    updateVersionFrom2To3() {
+        Settings.instance().createSetting('fileSystemMapping', {}).set({});
+        removeSetting(Settings.instance().createSetting('fileMappingEntries', []));
+    }
+    updateVersionFrom3To4() {
+        const advancedMode = Settings.instance().createSetting('showHeaSnapshotObjectsHiddenProperties', false);
+        moduleSetting('showAdvancedHeapSnapshotProperties').set(advancedMode.get());
+        removeSetting(advancedMode);
+    }
+    updateVersionFrom4To5() {
+        const settingNames = {
+            FileSystemViewSidebarWidth: 'fileSystemViewSplitViewState',
+            elementsSidebarWidth: 'elementsPanelSplitViewState',
+            StylesPaneSplitRatio: 'stylesPaneSplitViewState',
+            heapSnapshotRetainersViewSize: 'heapSnapshotSplitViewState',
+            'InspectorView.splitView': 'InspectorView.splitViewState',
+            'InspectorView.screencastSplitView': 'InspectorView.screencastSplitViewState',
+            'Inspector.drawerSplitView': 'Inspector.drawerSplitViewState',
+            layerDetailsSplitView: 'layerDetailsSplitViewState',
+            networkSidebarWidth: 'networkPanelSplitViewState',
+            sourcesSidebarWidth: 'sourcesPanelSplitViewState',
+            scriptsPanelNavigatorSidebarWidth: 'sourcesPanelNavigatorSplitViewState',
+            sourcesPanelSplitSidebarRatio: 'sourcesPanelDebuggerSidebarSplitViewState',
+            'timeline-details': 'timelinePanelDetailsSplitViewState',
+            'timeline-split': 'timelinePanelRecorsSplitViewState',
+            'timeline-view': 'timelinePanelTimelineStackSplitViewState',
+            auditsSidebarWidth: 'auditsPanelSplitViewState',
+            layersSidebarWidth: 'layersPanelSplitViewState',
+            profilesSidebarWidth: 'profilesPanelSplitViewState',
+            resourcesSidebarWidth: 'resourcesPanelSplitViewState',
+        };
+        const empty = {};
+        for (const oldName in settingNames) {
+            const newName = settingNames[oldName];
+            const oldNameH = oldName + 'H';
+            let newValue = null;
+            const oldSetting = Settings.instance().createSetting(oldName, empty);
+            if (oldSetting.get() !== empty) {
+                newValue = newValue || {};
+                // @ts-expect-error
+                newValue.vertical = {};
+                // @ts-expect-error
+                newValue.vertical.size = oldSetting.get();
+                removeSetting(oldSetting);
+            }
+            const oldSettingH = Settings.instance().createSetting(oldNameH, empty);
+            if (oldSettingH.get() !== empty) {
+                newValue = newValue || {};
+                // @ts-expect-error
+                newValue.horizontal = {};
+                // @ts-expect-error
+                newValue.horizontal.size = oldSettingH.get();
+                removeSetting(oldSettingH);
+            }
+            if (newValue) {
+                Settings.instance().createSetting(newName, {}).set(newValue);
+            }
+        }
+    }
+    updateVersionFrom5To6() {
+        const settingNames = {
+            debuggerSidebarHidden: 'sourcesPanelSplitViewState',
+            navigatorHidden: 'sourcesPanelNavigatorSplitViewState',
+            'WebInspector.Drawer.showOnLoad': 'Inspector.drawerSplitViewState',
+        };
+        for (const oldName in settingNames) {
+            const oldSetting = Settings.instance().createSetting(oldName, null);
+            if (oldSetting.get() === null) {
+                removeSetting(oldSetting);
+                continue;
+            }
+            const newName = settingNames[oldName];
+            const invert = oldName === 'WebInspector.Drawer.showOnLoad';
+            const hidden = oldSetting.get() !== invert;
+            removeSetting(oldSetting);
+            const showMode = hidden ? 'OnlyMain' : 'Both';
+            const newSetting = Settings.instance().createSetting(newName, {});
+            const newValue = newSetting.get() || {};
+            // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+            // @ts-expect-error
+            newValue.vertical = newValue.vertical || {};
+            // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+            // @ts-expect-error
+            newValue.vertical.showMode = showMode;
+            // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+            // @ts-expect-error
+            newValue.horizontal = newValue.horizontal || {};
+            // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+            // @ts-expect-error
+            newValue.horizontal.showMode = showMode;
+            newSetting.set(newValue);
+        }
+    }
+    updateVersionFrom6To7() {
+        const settingNames = {
+            sourcesPanelNavigatorSplitViewState: 'sourcesPanelNavigatorSplitViewState',
+            elementsPanelSplitViewState: 'elementsPanelSplitViewState',
+            stylesPaneSplitViewState: 'stylesPaneSplitViewState',
+            sourcesPanelDebuggerSidebarSplitViewState: 'sourcesPanelDebuggerSidebarSplitViewState',
+        };
+        const empty = {};
+        for (const name in settingNames) {
+            const setting = Settings.instance().createSetting(name, empty);
+            const value = setting.get();
+            if (value === empty) {
+                continue;
+            }
+            // Zero out saved percentage sizes, and they will be restored to defaults.
+            if (value.vertical?.size && value.vertical.size < 1) {
+                value.vertical.size = 0;
+            }
+            if (value.horizontal?.size && value.horizontal.size < 1) {
+                value.horizontal.size = 0;
+            }
+            setting.set(value);
+        }
+    }
+    updateVersionFrom7To8() {
+    }
+    updateVersionFrom8To9() {
+        const settingNames = ['skipStackFramesPattern', 'workspaceFolderExcludePattern'];
+        for (let i = 0; i < settingNames.length; ++i) {
+            const setting = Settings.instance().createSetting(settingNames[i], '');
+            let value = setting.get();
+            if (!value) {
+                return;
+            }
+            if (typeof value === 'string') {
+                value = [value];
+            }
+            for (let j = 0; j < value.length; ++j) {
+                if (typeof value[j] === 'string') {
+                    value[j] = { pattern: value[j] };
+                }
+            }
+            setting.set(value);
+        }
+    }
+    updateVersionFrom9To10() {
+        // This one is localStorage specific, which is fine.
+        if (!window.localStorage) {
+            return;
+        }
+        for (const key in window.localStorage) {
+            if (key.startsWith('revision-history')) {
+                window.localStorage.removeItem(key);
+            }
+        }
+    }
+    updateVersionFrom10To11() {
+        const oldSettingName = 'customDevicePresets';
+        const newSettingName = 'customEmulatedDeviceList';
+        const oldSetting = Settings.instance().createSetting(oldSettingName, undefined);
+        const list = oldSetting.get();
+        if (!Array.isArray(list)) {
+            return;
+        }
+        const newList = [];
+        for (let i = 0; i < list.length; ++i) {
+            const value = list[i];
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const device = {};
+            device['title'] = value['title'];
+            device['type'] = 'unknown';
+            device['user-agent'] = value['userAgent'];
+            device['capabilities'] = [];
+            if (value['touch']) {
+                device['capabilities'].push('touch');
+            }
+            if (value['mobile']) {
+                device['capabilities'].push('mobile');
+            }
+            device['screen'] = {};
+            device['screen']['vertical'] = { width: value['width'], height: value['height'] };
+            device['screen']['horizontal'] = { width: value['height'], height: value['width'] };
+            device['screen']['device-pixel-ratio'] = value['deviceScaleFactor'];
+            device['modes'] = [];
+            device['show-by-default'] = true;
+            device['show'] = 'Default';
+            newList.push(device);
+        }
+        if (newList.length) {
+            Settings.instance().createSetting(newSettingName, []).set(newList);
+        }
+        removeSetting(oldSetting);
+    }
+    updateVersionFrom11To12() {
+        this.migrateSettingsFromLocalStorage();
+    }
+    updateVersionFrom12To13() {
+        this.migrateSettingsFromLocalStorage();
+        removeSetting(Settings.instance().createSetting('timelineOverviewMode', ''));
+    }
+    updateVersionFrom13To14() {
+        const defaultValue = { throughput: -1, latency: 0 };
+        Settings.instance().createSetting('networkConditions', defaultValue).set(defaultValue);
+    }
+    updateVersionFrom14To15() {
+        // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const setting = Settings.instance().createLocalSetting('workspaceExcludedFolders', {});
+        const oldValue = setting.get();
+        const newValue = {};
+        for (const fileSystemPath in oldValue) {
+            newValue[fileSystemPath] = [];
+            for (const entry of oldValue[fileSystemPath]) {
+                newValue[fileSystemPath].push(entry.path);
+            }
+        }
+        setting.set(newValue);
+    }
+    updateVersionFrom15To16() {
+        // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const setting = Settings.instance().createSetting('InspectorView.panelOrder', {});
+        const tabOrders = setting.get();
+        for (const key of Object.keys(tabOrders)) {
+            tabOrders[key] = (tabOrders[key] + 1) * 10;
+        }
+        setting.set(tabOrders);
+    }
+    updateVersionFrom16To17() {
+        // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const setting = Settings.instance().createSetting('networkConditionsCustomProfiles', []);
+        const oldValue = setting.get();
+        const newValue = [];
+        if (Array.isArray(oldValue)) {
+            for (const preset of oldValue) {
+                if (typeof preset.title === 'string' && typeof preset.value === 'object' &&
+                    typeof preset.value.throughput === 'number' && typeof preset.value.latency === 'number') {
+                    newValue.push({
+                        title: preset.title,
+                        value: { download: preset.value.throughput, upload: preset.value.throughput, latency: preset.value.latency },
+                    });
+                }
+            }
+        }
+        setting.set(newValue);
+    }
+    updateVersionFrom17To18() {
+        // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const setting = Settings.instance().createLocalSetting('workspaceExcludedFolders', {});
+        const oldValue = setting.get();
+        const newValue = {};
+        for (const oldKey in oldValue) {
+            let newKey = oldKey.replace(/\\/g, '/');
+            if (!newKey.startsWith('file://')) {
+                if (newKey.startsWith('/')) {
+                    newKey = 'file://' + newKey;
+                }
+                else {
+                    newKey = 'file:///' + newKey;
+                }
+            }
+            newValue[newKey] = oldValue[oldKey];
+        }
+        setting.set(newValue);
+    }
+    updateVersionFrom18To19() {
+        const defaultColumns = { status: true, type: true, initiator: true, size: true, time: true };
+        // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const visibleColumnSettings = Settings.instance().createSetting('networkLogColumnsVisibility', defaultColumns);
+        const visibleColumns = visibleColumnSettings.get();
+        visibleColumns.name = true;
+        visibleColumns.timeline = true;
+        const configs = {};
+        for (const columnId in visibleColumns) {
+            if (!visibleColumns.hasOwnProperty(columnId)) {
+                continue;
+            }
+            configs[columnId.toLowerCase()] = { visible: visibleColumns[columnId] };
+        }
+        const newSetting = Settings.instance().createSetting('networkLogColumns', {});
+        newSetting.set(configs);
+        removeSetting(visibleColumnSettings);
+    }
+    updateVersionFrom19To20() {
+        const oldSetting = Settings.instance().createSetting('InspectorView.panelOrder', {});
+        const newSetting = Settings.instance().createSetting('panel-tabOrder', {});
+        newSetting.set(oldSetting.get());
+        removeSetting(oldSetting);
+    }
+    updateVersionFrom20To21() {
+        const networkColumns = Settings.instance().createSetting('networkLogColumns', {});
+        const columns = networkColumns.get();
+        delete columns['timeline'];
+        delete columns['waterfall'];
+        networkColumns.set(columns);
+    }
+    updateVersionFrom21To22() {
+        // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const breakpointsSetting = Settings.instance().createLocalSetting('breakpoints', []);
+        const breakpoints = breakpointsSetting.get();
+        for (const breakpoint of breakpoints) {
+            breakpoint['url'] = breakpoint['sourceFileId'];
+            delete breakpoint['sourceFileId'];
+        }
+        breakpointsSetting.set(breakpoints);
+    }
+    updateVersionFrom22To23() {
+        // This update is no-op.
+    }
+    updateVersionFrom23To24() {
+        const oldSetting = Settings.instance().createSetting('searchInContentScripts', false);
+        const newSetting = Settings.instance().createSetting('searchInAnonymousAndContentScripts', false);
+        newSetting.set(oldSetting.get());
+        removeSetting(oldSetting);
+    }
+    updateVersionFrom24To25() {
+        const defaultColumns = { status: true, type: true, initiator: true, size: true, time: true };
+        // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const networkLogColumnsSetting = Settings.instance().createSetting('networkLogColumns', defaultColumns);
+        const columns = networkLogColumnsSetting.get();
+        delete columns.product;
+        networkLogColumnsSetting.set(columns);
+    }
+    updateVersionFrom25To26() {
+        const oldSetting = Settings.instance().createSetting('messageURLFilters', {});
+        const urls = Object.keys(oldSetting.get());
+        const textFilter = urls.map(url => `-url:${url}`).join(' ');
+        if (textFilter) {
+            // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const textFilterSetting = Settings.instance().createSetting('console.textFilter', '');
+            const suffix = textFilterSetting.get() ? ` ${textFilterSetting.get()}` : '';
+            textFilterSetting.set(`${textFilter}${suffix}`);
+        }
+        removeSetting(oldSetting);
+    }
+    updateVersionFrom26To27() {
+        function renameKeyInObjectSetting(settingName, from, to) {
+            // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const setting = Settings.instance().createSetting(settingName, {});
+            const value = setting.get();
+            if (from in value) {
+                value[to] = value[from];
+                delete value[from];
+                setting.set(value);
+            }
+        }
+        function renameInStringSetting(settingName, from, to) {
+            const setting = Settings.instance().createSetting(settingName, '');
+            const value = setting.get();
+            if (value === from) {
+                setting.set(to);
+            }
+        }
+        renameKeyInObjectSetting('panel-tabOrder', 'audits2', 'audits');
+        renameKeyInObjectSetting('panel-closeableTabs', 'audits2', 'audits');
+        renameInStringSetting('panel-selectedTab', 'audits2', 'audits');
+    }
+    updateVersionFrom27To28() {
+        const setting = Settings.instance().createSetting('uiTheme', 'systemPreferred');
+        if (setting.get() === 'default') {
+            setting.set('systemPreferred');
+        }
+    }
+    updateVersionFrom28To29() {
+        function renameKeyInObjectSetting(settingName, from, to) {
+            // TODO(crbug.com/1172300) Ignored during the jsdoc to ts migration
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const setting = Settings.instance().createSetting(settingName, {});
+            const value = setting.get();
+            if (from in value) {
+                value[to] = value[from];
+                delete value[from];
+                setting.set(value);
+            }
+        }
+        function renameInStringSetting(settingName, from, to) {
+            const setting = Settings.instance().createSetting(settingName, '');
+            const value = setting.get();
+            if (value === from) {
+                setting.set(to);
+            }
+        }
+        renameKeyInObjectSetting('panel-tabOrder', 'audits', 'lighthouse');
+        renameKeyInObjectSetting('panel-closeableTabs', 'audits', 'lighthouse');
+        renameInStringSetting('panel-selectedTab', 'audits', 'lighthouse');
+    }
+    updateVersionFrom29To30() {
+        // Create new location agnostic setting
+        const closeableTabSetting = Settings.instance().createSetting('closeableTabs', {});
+        // Read current settings
+        const panelCloseableTabSetting = Settings.instance().createSetting('panel-closeableTabs', {});
+        const drawerCloseableTabSetting = Settings.instance().createSetting('drawer-view-closeableTabs', {});
+        const openTabsInPanel = panelCloseableTabSetting.get();
+        const openTabsInDrawer = panelCloseableTabSetting.get();
+        // Set #value of new setting
+        const newValue = Object.assign(openTabsInDrawer, openTabsInPanel);
+        closeableTabSetting.set(newValue);
+        // Remove old settings
+        removeSetting(panelCloseableTabSetting);
+        removeSetting(drawerCloseableTabSetting);
+    }
+    updateVersionFrom30To31() {
+        // Remove recorder_recordings setting that was used for storing recordings
+        // by an old recorder experiment.
+        const recordingsSetting = Settings.instance().createSetting('recorder_recordings', []);
+        removeSetting(recordingsSetting);
+    }
+    updateVersionFrom31To32() {
+        // Introduce the new 'resourceTypeName' property on stored breakpoints. Prior to
+        // this change we synchronized the breakpoint only by URL, but since we don't
+        // know on which resource type the given breakpoint was set, we just assume
+        // 'script' here to keep things simple.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const breakpointsSetting = Settings.instance().createLocalSetting('breakpoints', []);
+        const breakpoints = breakpointsSetting.get();
+        for (const breakpoint of breakpoints) {
+            breakpoint['resourceTypeName'] = 'script';
+        }
+        breakpointsSetting.set(breakpoints);
+    }
+    updateVersionFrom32To33() {
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const previouslyViewedFilesSetting = Settings.instance().createLocalSetting('previouslyViewedFiles', []);
+        let previouslyViewedFiles = previouslyViewedFilesSetting.get();
+        // Discard old 'previouslyViewedFiles' items that don't have a 'url' property.
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        previouslyViewedFiles = previouslyViewedFiles.filter((previouslyViewedFile) => 'url' in previouslyViewedFile);
+        // Introduce the new 'resourceTypeName' property on previously viewed files.
+        // Prior to this change we only keyed them based on the URL, but since we
+        // don't know which resource type the given file had, we just assume 'script'
+        // here to keep things simple.
+        for (const previouslyViewedFile of previouslyViewedFiles) {
+            previouslyViewedFile['resourceTypeName'] = 'script';
+        }
+        previouslyViewedFilesSetting.set(previouslyViewedFiles);
+    }
+    updateVersionFrom33To34() {
+        // Introduces the 'isLogpoint' property on stored breakpoints. This information was
+        // previously encoded in the 'condition' itself. This migration leaves the condition
+        // alone but ensures that 'isLogpoint' is accurate for already stored breakpoints.
+        // This enables us to use the 'isLogpoint' property in code.
+        // A separate migration will remove the special encoding from the condition itself
+        // once all refactorings are done.
+        // The prefix/suffix are hardcoded here, since these constants will be removed in
+        // the future.
+        const logpointPrefix = '/** DEVTOOLS_LOGPOINT */ console.log(';
+        const logpointSuffix = ')';
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const breakpointsSetting = Settings.instance().createLocalSetting('breakpoints', []);
+        const breakpoints = breakpointsSetting.get();
+        for (const breakpoint of breakpoints) {
+            const isLogpoint = breakpoint.condition.startsWith(logpointPrefix) && breakpoint.condition.endsWith(logpointSuffix);
+            breakpoint['isLogpoint'] = isLogpoint;
+        }
+        breakpointsSetting.set(breakpoints);
+    }
+    updateVersionFrom34To35() {
+        // Uses the 'isLogpoint' property on stored breakpoints to remove the prefix/suffix
+        // from logpoints. This way, we store the entered log point condition as the user
+        // entered it.
+        // The prefix/suffix are hardcoded here, since these constants will be removed in
+        // the future.
+        const logpointPrefix = '/** DEVTOOLS_LOGPOINT */ console.log(';
+        const logpointSuffix = ')';
+        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+        const breakpointsSetting = Settings.instance().createLocalSetting('breakpoints', []);
+        const breakpoints = breakpointsSetting.get();
+        for (const breakpoint of breakpoints) {
+            const { condition, isLogpoint } = breakpoint;
+            if (isLogpoint) {
+                breakpoint.condition = condition.slice(logpointPrefix.length, condition.length - logpointSuffix.length);
+            }
+        }
+        breakpointsSetting.set(breakpoints);
+    }
+    updateVersionFrom35To36() {
+        // We have changed the default from 'false' to 'true' and this updates the existing setting just for once.
+        Settings.instance().createSetting('showThirdPartyIssues', true).set(true);
+    }
+    updateVersionFrom36To37() {
+        const updateStorage = (storage) => {
+            for (const key of storage.keys()) {
+                const normalizedKey = Settings.normalizeSettingName(key);
+                if (normalizedKey !== key) {
+                    const value = storage.get(key);
+                    removeSetting({ name: key, storage });
+                    storage.set(normalizedKey, value);
+                }
+            }
+        };
+        updateStorage(Settings.instance().globalStorage);
+        updateStorage(Settings.instance().syncedStorage);
+        updateStorage(Settings.instance().localStorage);
+        for (const key of Settings.instance().globalStorage.keys()) {
+            if ((key.startsWith('data-grid-') && key.endsWith('-column-weights')) || key.endsWith('-tab-order') ||
+                key === 'views-location-override' || key === 'closeable-tabs') {
+                const setting = Settings.instance().createSetting(key, {});
+                setting.set(Platform.StringUtilities.toKebabCaseKeys(setting.get()));
+            }
+            if (key.endsWith('-selected-tab')) {
+                const setting = Settings.instance().createSetting(key, '');
+                setting.set(Platform.StringUtilities.toKebabCase(setting.get()));
+            }
+        }
+    }
+    updateVersionFrom37To38() {
+        const getConsoleInsightsEnabledSetting = () => {
+            try {
+                return moduleSetting('console-insights-enabled');
+            }
+            catch {
+                return;
+            }
+        };
+        const consoleInsightsEnabled = getConsoleInsightsEnabledSetting();
+        const onboardingFinished = Settings.instance().createLocalSetting('console-insights-onboarding-finished', false);
+        if (consoleInsightsEnabled && consoleInsightsEnabled.get() === true && onboardingFinished.get() === false) {
+            consoleInsightsEnabled.set(false);
+        }
+        if (consoleInsightsEnabled && consoleInsightsEnabled.get() === false) {
+            onboardingFinished.set(false);
+        }
+    }
+    updateVersionFrom38To39() {
+        const PREFERRED_NETWORK_COND = 'preferred-network-condition';
+        // crrev.com/c/5582013 renamed "Slow 3G" to "3G" and "Fast 3G" => "Slow 4G".
+        // Any users with the old values need to have them moved to avoid breaking DevTools.
+        // Note: we load the raw value via the globalStorage here because
+        // `createSetting` creates if it is not present, and we do not want that;
+        // we only want to update existing, old values.
+        const setting = Settings.instance().globalStorage.get(PREFERRED_NETWORK_COND);
+        if (!setting) {
+            return;
+        }
+        try {
+            const networkSetting = JSON.parse(setting);
+            if (networkSetting.title === 'Slow 3G') {
+                networkSetting.title = '3G';
+                networkSetting.i18nTitleKey = '3G';
+                Settings.instance().globalStorage.set(PREFERRED_NETWORK_COND, JSON.stringify(networkSetting));
+            }
+            else if (networkSetting.title === 'Fast 3G') {
+                networkSetting.title = 'Slow 4G';
+                networkSetting.i18nTitleKey = 'Slow 4G';
+                Settings.instance().globalStorage.set(PREFERRED_NETWORK_COND, JSON.stringify(networkSetting));
+            }
+        }
+        catch {
+            // If parsing the setting threw, it's in some invalid state, so remove it.
+            Settings.instance().globalStorage.remove(PREFERRED_NETWORK_COND);
+        }
+    }
+    /**
+     * There are two related migrations here for handling network throttling persistence:
+     * 1. Go through all user custom throttling conditions and add a `key` property.
+     * 2. If the user has a 'preferred-network-condition' setting, take the value
+     *    of that and set the right key for the new 'active-network-condition-key'
+     *    setting. Then, remove the now-obsolete 'preferred-network-condition'
+     *    setting.
+     */
+    updateVersionFrom39To40() {
+        const hasCustomNetworkConditionsSetting = () => {
+            try {
+                // this will error if it does not exist
+                moduleSetting('custom-network-conditions');
+                return true;
+            }
+            catch {
+                return false;
+            }
+        };
+        if (hasCustomNetworkConditionsSetting()) {
+            /**
+             * We added keys to custom network throttling conditions in M140, so we
+             * need to go through any existing profiles the user has and add the key to
+             * them.
+             * We can't use the SDK.NetworkManager.Condition here as it would be a
+             * circular dependency. All that matters is that these conditions are
+             * objects, and we need to set the right key on each one. The actual keys &
+             * values in the object are not important.
+             */
+            const conditionsSetting = moduleSetting('custom-network-conditions');
+            const customConditions = conditionsSetting.get();
+            if (customConditions?.length > 0) {
+                customConditions.forEach((condition, i) => {
+                    // This could be run multiple times, make sure that we don't override any
+                    // existing keys.
+                    if (condition.key) {
+                        return;
+                    }
+                    // The format of this key is important: see
+                    // SDK.NetworkManager.UserDefinedThrottlingConditionKey
+                    condition.key = `USER_CUSTOM_SETTING_${i + 1}`;
+                });
+                conditionsSetting.set(customConditions);
+            }
+        }
+        // Additionally, we need to make sure we persist the right throttling for
+        // users who have a preferred-network-condition set.
+        const PREFERRED_NETWORK_COND_SETTING = 'preferred-network-condition';
+        // We shipped a change to how we persist network throttling conditions and
+        // added a `key` property rather than rely on any user visible string which
+        // is more likely to change. This migration step tries to update the
+        // setting for users, or removes it if we fail, so they start fresh next
+        // time they load DevTools.
+        const setting = Settings.instance().globalStorage.get(PREFERRED_NETWORK_COND_SETTING);
+        if (!setting) {
+            return;
+        }
+        // The keys here are the UI Strings as of July 2025 (shipped in M139).
+        // This migration shipped in M140. The values are the values of the
+        // `PredefinedThrottlingConditionKey` in SDK.NetworkManager.
+        const UI_STRING_TO_NEW_KEY = {
+            'Fast 4G': 'SPEED_FAST_4G',
+            'Slow 4G': 'SPEED_SLOW_4G',
+            '3G': 'SPEED_3G',
+            'No throttling': 'NO_THROTTLING',
+            Offline: 'OFFLINE'
+        };
+        try {
+            const networkSetting = JSON.parse(setting);
+            if (networkSetting.i18nTitleKey && UI_STRING_TO_NEW_KEY.hasOwnProperty(networkSetting.i18nTitleKey)) {
+                const key = UI_STRING_TO_NEW_KEY[networkSetting.i18nTitleKey];
+                // The second argument is the default value, so it's important that we
+                // set this to the default, and then update it to the new key.
+                const newSetting = Settings.instance().createSetting('active-network-condition-key', 'NO_THROTTLING');
+                newSetting.set(key);
+            }
+        }
+        finally {
+            // This setting is now not used, so we can remove it.
+            Settings.instance().globalStorage.remove(PREFERRED_NETWORK_COND_SETTING);
+        }
+    }
+    /*
+     * Any new migration should be added before this comment.
+     *
+     * IMPORTANT: Migrations must be idempotent, since they may be applied
+     * multiple times! E.g. when renaming a setting one has to check that the
+     * a setting with the new name does not yet exist.
+     * ----------------------------------------------------------------------- */
+    migrateSettingsFromLocalStorage() {
+        // This step migrates all the settings except for the ones below into the browser profile.
+        const localSettings = new Set([
+            'advancedSearchConfig',
+            'breakpoints',
+            'consoleHistory',
+            'domBreakpoints',
+            'eventListenerBreakpoints',
+            'fileSystemMapping',
+            'lastSelectedSourcesSidebarPaneTab',
+            'previouslyViewedFiles',
+            'savedURLs',
+            'watchExpressions',
+            'workspaceExcludedFolders',
+            'xhrBreakpoints',
+        ]);
+        if (!window.localStorage) {
+            return;
+        }
+        for (const key in window.localStorage) {
+            if (localSettings.has(key)) {
+                continue;
+            }
+            const value = window.localStorage[key];
+            window.localStorage.removeItem(key);
+            Settings.instance().globalStorage.set(key, value);
+        }
+    }
+    clearBreakpointsWhenTooMany(breakpointsSetting, maxBreakpointsCount) {
+        // If there are too many breakpoints in a storage, it is likely due to a recent bug that caused
+        // periodical breakpoints duplication leading to inspector slowness.
+        if (breakpointsSetting.get().length > maxBreakpointsCount) {
+            breakpointsSetting.set([]);
+        }
+    }
+}
+export function moduleSetting(settingName) {
+    return Settings.instance().moduleSetting(settingName);
+}
+export function settingForTest(settingName) {
+    return Settings.instance().settingForTest(settingName);
+}
+export { getLocalizedSettingsCategory, maybeRemoveSettingExtension, registerSettingExtension, registerSettingsForTest, resetSettings, };