@bokeh/bokehjs/build/js/lib/embed/notebook.js

Interactive, novel data visualization

import { Document } from "../document";
import { Receiver } from "../protocol/receiver";
import { logger } from "../core/logging";
import { size, values } from "../core/util/object";
import { add_document_standalone } from "./standalone";
import { _resolve_element, _resolve_root_elements } from "./dom";
// This exists to allow the @bokeh/jupyter_bokeh extension to store the
// notebook kernel so that _init_comms can register the comms target.
// This has to be available at Bokeh.embed.kernels in JupyterLab.
export const kernels = {};
function _handle_notebook_comms(receiver, comm_msg) {
    if (comm_msg.buffers.length > 0) {
        receiver.consume(comm_msg.buffers[0].buffer);
    }
    else {
        receiver.consume(comm_msg.content.data);
    }
    const msg = receiver.message;
    if (msg != null) {
        this.apply_json_patch(msg.content, msg.buffers);
    }
}
function _init_comms(target, doc) {
    if (typeof Jupyter !== "undefined" && Jupyter.notebook.kernel != null) {
        logger.info(`Registering Jupyter comms for target ${target}`);
        const comm_manager = Jupyter.notebook.kernel.comm_manager;
        try {
            comm_manager.register_target(target, (comm) => {
                logger.info(`Registering Jupyter comms for target ${target}`);
                const r = new Receiver();
                comm.on_msg(_handle_notebook_comms.bind(doc, r));
            });
        }
        catch (e) {
            logger.warn(`Jupyter comms failed to register. push_notebook() will not function. (exception reported: ${e})`);
        }
    }
    else if (doc.roots()[0].id in kernels) {
        logger.info(`Registering JupyterLab comms for target ${target}`);
        const kernel = kernels[doc.roots()[0].id];
        try {
            kernel.registerCommTarget(target, (comm) => {
                logger.info(`Registering JupyterLab comms for target ${target}`);
                const r = new Receiver();
                comm.onMsg = _handle_notebook_comms.bind(doc, r);
            });
        }
        catch (e) {
            logger.warn(`Jupyter comms failed to register. push_notebook() will not function. (exception reported: ${e})`);
        }
    }
    else if (typeof google != "undefined" && google.colab.kernel != null) {
        logger.info(`Registering Google Colab comms for target ${target}`);
        const comm_manager = google.colab.kernel.comms;
        try {
            comm_manager.registerTarget(target, async (comm) => {
                logger.info(`Registering Google Colab comms for target ${target}`);
                const r = new Receiver();
                for await (const message of comm.messages) {
                    const content = { data: message.data };
                    const buffers = [];
                    for (const buffer of message.buffers ?? []) {
                        buffers.push(new DataView(buffer));
                    }
                    const msg = { content, buffers };
                    _handle_notebook_comms.bind(doc)(r, msg);
                }
            });
        }
        catch (e) {
            logger.warn(`Google Colab comms failed to register. push_notebook() will not function. (exception reported: ${e})`);
        }
    }
    else {
        console.warn("Jupyter notebooks comms not available. push_notebook() will not function. If running JupyterLab ensure the latest @bokeh/jupyter_bokeh extension is installed. In an exported notebook this warning is expected.");
    }
}
export async function embed_items_notebook(docs_json, render_items) {
    if (size(docs_json) != 1) {
        throw new Error("embed_items_notebook expects exactly one document in docs_json");
    }
    const document = Document.from_json(values(docs_json)[0]);
    for (const item of render_items) {
        if (item.notebook_comms_target != null) {
            _init_comms(item.notebook_comms_target, document);
        }
        const element = _resolve_element(item);
        const roots = _resolve_root_elements(item);
        await add_document_standalone(document, element, roots);
        for (const root of roots) {
            if (root instanceof HTMLElement) {
                root.removeAttribute("id");
            }
        }
    }
}
//# sourceMappingURL=notebook.js.map