Method init

src/background/tab-manager.ts:69–256

({getConnectionMessage, onColorSchemeChange, getTabMessage}: TabManagerOptions)

    private static readonly LOCAL_STORAGE_KEY = 'TabManager-state';

    static init({getConnectionMessage, onColorSchemeChange, getTabMessage}: TabManagerOptions): void {
        TabManager.stateManager = new StateManager<TabManagerState>(TabManager.LOCAL_STORAGE_KEY, this, {tabs: {}, timestamp: 0}, logWarn);
        TabManager.tabs = {};
        TabManager.onColorSchemeChange = onColorSchemeChange;
        TabManager.getTabMessage = getTabMessage;

        chrome.runtime.onMessage.addListener((message: MessageCStoBG | MessageUItoBG, sender, sendResponse): boolean => {
            if (isFirefox && makeFirefoxHappy(message, sender, sendResponse)) {
                return false;
            }
            switch (message.type) {
                case MessageTypeCStoBG.DOCUMENT_CONNECT: {
                    if (__CHROMIUM_MV3__ && isPanel(sender)) {
                        sendResponse({
                            type: MessageTypeBGtoCS.UNSUPPORTED_SENDER,
                        });
                        return false;
                    }
                    TabManager.onColorSchemeMessage(message, sender);

                    const reply = (tabURL: string, url: string, isTopFrame: boolean, topFrameHasDarkTheme?: boolean) => {
                        getConnectionMessage(tabURL, url, isTopFrame, topFrameHasDarkTheme).then((response) => {
                            if (!response) {
                                return;
                            }
                            response.scriptId = message.scriptId!;
                            TabManager.sendDocumentMessage(sender.tab!.id!, sender.documentId!, response, sender.frameId!);
                        });
                    };

                    if (isPanel(sender)) {
                        // NOTE: Vivaldi and Opera can show a page in a side panel,
                        // but it is not possible to handle messaging correctly (no tab ID, frame ID).
                        if (isFirefox) {
                            if (sender && sender.tab && typeof sender.tab.id === 'number') {
                                chrome.tabs.sendMessage<MessageBGtoCS>(sender.tab.id,
                                    {
                                        type: MessageTypeBGtoCS.UNSUPPORTED_SENDER,
                                        scriptId: message.scriptId!,
                                    },
                                    {
                                        frameId: sender && typeof sender.frameId === 'number' ? sender.frameId : undefined,
                                    });
                            }
                        } else {
                            sendResponse('unsupportedSender');
                        }
                        return false;
                    }

                    const {frameId} = sender;
                    const isTopFrame: boolean = (__CHROMIUM_MV2__ || __CHROMIUM_MV3__) ? (frameId === 0 || message.data.isTopFrame) : frameId === 0;
                    const url = sender.url!;
                    const tabId = sender.tab!.id!;
                    const scriptId = message.scriptId!;
                    // Chromium 106+ may prerender frames resulting in top-level frames with chrome.runtime.MessageSender.tab.url
                    // set to chrome://newtab/ and positive chrome.runtime.MessageSender.frameId
                    const tabURL = ((__CHROMIUM_MV2__ || __CHROMIUM_MV3__) && isTopFrame) ? url : sender.tab!.url!;