Method handleMessage

src/helpViewer/panel.ts:270–359

(msg: OutMessage)

    // handle message produced by javascript inside the help page
    private async handleMessage(msg: OutMessage) {
        if (msg.message === 'linkClicked') {
            // handle hyperlinks clicked in the webview
            // normal navigation does not work in webviews (even on localhost)
            const href: string = msg.href || '';
            const currentScrollY: number = Number(msg.scrollY) || 0;
            console.log('Link clicked: ' + href);

            // remove first to path entries (if these are webview internal stuff):
            const uri = vscode.Uri.parse(href);
            const parts = uri.path.split('/');
            if (parts[0] !== 'library' && parts[0] !== 'doc') {
                parts.shift();
            }
            if (parts[0] !== 'library' && parts[0] !== 'doc') {
                parts.shift();
            }

            // actual request path as used by R:
            const requestPath = parts.join('/');

            // retrieve helpfile for path:
            const helpFile = await this.rHelp.getHelpFileForPath(requestPath);

            // if successful, show helpfile:
            if (helpFile) {
                if (uri.fragment) {
                    helpFile.hash = '#' + uri.fragment;
                } else {
                    helpFile.scrollY = 0;
                }
                if (uri.path.endsWith('.pdf')) {
                    void this.openInExternalBrowser(helpFile);
                } else if (uri.path.endsWith('.R')) {
                    const doc = await vscode.workspace.openTextDocument({
                        language: 'r',
                        content: helpFile.html0
                    });
                    void vscode.window.showTextDocument(doc);
                } else {
                    void this.showHelpFile(helpFile, true, currentScrollY);
                }
            } else{
                void vscode.window.showWarningMessage(`Did not find help page for path ${requestPath}`);
            }
        } else if (msg.message === 'mouseClick') {
            // use the additional mouse buttons to go forward/backwards
            const currentScrollY = Number(msg.scrollY) || 0;
            const button: number = Number(msg.button) || 0;
            if (button === 3) {
                this._goBack(currentScrollY);
            } else if (button === 4) {
                this._goForward(currentScrollY);
            }
        } else if (msg.message === 'codeClicked') {
            if (!msg.code) {
                return;
            }