Events

The events section allows to change all the functions pertaining to the events.

  • onAppReady - the application is loaded into the browser.
  • onCollaborativeChanges - the document is co-edited by the other user in the strict co-editing mode.
  • onDocumentReady - the document is loaded into the document editor.
  • onDocumentStateChange - the document is modified.
  • onDownloadAs - the absolute URL to the edited file when the downloadAs method is being called.
  • onError - an error or some other specific event occurs.
  • onInfo - the application opened the file.
  • onMetaChange - the meta information of the document is changed via the meta command.
  • onMakeActionLink - the user is trying to get link for opening the document which contains a bookmark, scrolling to the bookmark position.
  • onOutdatedVersion - the document is opened for editing with the old document.key value, which was used to edit the previous document version and was successfully saved.
  • onPluginsReady - all plugins are loaded and can be used.
  • onReady - the application is loaded into the browser.
  • onRequestClose - the work with the editor must be ended and the editor must be closed.
  • onRequestCompareFile - the user is trying to select document for comparing by clicking the Document from Storage button.
  • onRequestCreateNew - the user is trying to create document by clicking the Create New button.
  • onRequestEditRights - the user is trying to switch the document from the viewing into the editing mode by clicking the Edit Document button.
  • onRequestHistory - the user is trying to show the document version history by clicking the Version History button.
  • onRequestHistoryClose - the user is trying to go back to the document from viewing the document version history by clicking the Close History button.
  • onRequestHistoryData - the user is trying to click the specific document version in the document version history.
  • onRequestInsertImage - the user is trying to insert an image by clicking the Image from Storage button.
  • onRequestMailMergeRecipients - the user is trying to select recipients data by clicking the Mail merge button.
  • onRequestOpen - the user is trying to open an external link.
  • onRequestReferenceData - the user is trying to refresh data inserted from the external file by clicking the Update values button in the External links dialog box of the Data tab.
  • onRequestReferenceSource - the user is trying to change an external link by clicking the Change source button.
  • onRequestRename - the user is trying to rename the file by clicking the Rename... button.
  • onRequestRestore - the user is trying to restore the file version by clicking the Restore button in the version history.
  • onRequestSaveAs - the user is trying to save file by clicking Save Copy as... button.
  • onRequestSelectDocument - the user is trying to select a document for comparing or combining.
  • onRequestSelectSpreadsheet - the user is trying to select recipients data by clicking the Mail merge button.
  • onRequestSendNotify - the user is mentioned in a comment.
  • onRequestSharingSettings - the user is trying to manage document access rights by clicking Change access rights button.
  • onRequestUsers - the user can select other users to mention in the comments, grant the access rights to edit the specific sheet ranges, or set the user avatars.
  • onWarning - a warning occurs.
Example

Event messages will be available in your browser's DevTools console.

Events and their description:

  • onAppReady - the function called when the application is loaded into the browser.

    Example
    var onAppReady = function () {
        console.log("ONLYOFFICE Document Editor is ready");
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onAppReady": onAppReady,
            ...
        },
        ...
    });
    
  • onCollaborativeChanges - the function called when the document is co-edited by the other user in the strict co-editing mode.

    Example
    var onCollaborativeChanges = function () {
        console.log("The document changed by collaborative user");
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onCollaborativeChanges": onCollaborativeChanges,
            ...
        },
        ...
    });
    
  • onDocumentReady - the function called when the document is loaded into the document editor.

    Example
    var onDocumentReady = function () {
        console.log("Document is loaded");
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onDocumentReady": onDocumentReady,
            ...
        },
        ...
    });
    
  • onDocumentStateChange - the function called when the document is modified. It is called with the parameter: {"data": true} when the current user is editing the document and with the parameter: {"data" : false} when the current user's changes are sent to the document editing service.

    Example
    var onDocumentStateChange = function (event) {
        if (event.data) {
            console.log("The document changed");
        } else {
            console.log("Changes are collected on document editing service");
        }
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onDocumentStateChange": onDocumentStateChange,
            ...
        },
        ...
    });
    
  • onDownloadAs - the function called with the absolute URL to the edited file when the downloadAs method is being called. The absolute URL to the document to be downloaded and its type are sent in the data parameter.

    Example
    var onDownloadAs = function (event) {
        var fileType = event.data.fileType;
        var url = event.data.url;
        console.log("ONLYOFFICE Document Editor create file: " + url);
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onDownloadAs": onDownloadAs,
            ...
        },
        ...
    });
    
  • onError - the function called when an error or some other specific event occurs. The error message is sent in the data parameter. A list of error codes can be found here.

    Example
    var onError = function (event) {
        console.log("ONLYOFFICE Document Editor reports an error: code " + event.data.errorCode + ", description " + event.data.errorDescription);
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onError": onError,
            ...
        },
        ...
    });
    
  • onInfo - the function called when the application opened the file. The mode is sent in the data.mode parameter. Can be view or edit.

    Example
    var onInfo = function (event) {
        console.log("ONLYOFFICE Document Editor is opened in mode " + event.data.mode);
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onInfo": onInfo,
            ...
        },
        ...
    });
    
  • onMetaChange - the function called when the meta information of the document is changed via the meta command.

    The name of the document is sent in the data.title parameter. The Favorite icon highlighting state is sent in the data.favorite parameter.

    When the user clicks the Favorite icon, the setFavorite method is called to update the information about the Favorite icon highlighting state. If the method is not declared, the Favorite icon will not be changed.

    Example
    var onMetaChange = function (event) {
        var title = event.data.title;
        var favorite = event.data.favorite;
        ...
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onMetaChange": onMetaChange,
            ...
        },
        ...
    });
    
  • onMakeActionLink - the function called when the user is trying to get link for opening the document which contains a bookmark, scrolling to the bookmark position.

    To set the bookmark link, you must call the setActionLink method. The bookmark data is received in the data parameter and must be then used in the configuration as the value for the editorConfig.actionLink parameter. If the method is not declared the Get Link button will not be displayed.

    onMakeActionLink
    Example
    var onMakeActionLink = function (event){
        var ACTION_DATA = event.data;
        ...
        var link = GENERATE_LINK(ACTION_DATA);
        docEditor.setActionLink(link);
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onMakeActionLink": onMakeActionLink,
            ...
        },
        ...
    });
    
  • onOutdatedVersion - the function called after the error is shown, when the document is opened for editing with the old document.key value, which was used to edit the previous document version and was successfully saved. When this event is called the editor must be reinitialized with a new document.key.

    Example
    var onOutdatedVersion = function () {
        location.reload(true);
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onOutdatedVersion": onOutdatedVersion,
            ...
        },
        ...
    });
    
  • onPluginsReady - the function called when all plugins are loaded and can be used.

    Example
    var onPluginsReady = function () {
        ...
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onPluginsReady": onPluginsReady,
            ...
        },
        ...
    });
    
  • onReady - the function called when the application is loaded into the browser. Deprecated since version 5.0, please use onAppReady instead

  • onRequestClose - the function called when the work with the editor must be ended and the editor must be closed.

    Example
    var onRequestClose = function () {
        if (window.opener) {
            window.close();
            return;
        }
        docEditor.destroyEditor();
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestClose": onRequestClose,
            ...
        },
        ...
    });
    
  • onRequestCompareFile* - the function called when the user is trying to select document for comparing by clicking the Document from Storage button. Deprecated since version 7.5, please use onRequestSelectDocument instead.

    * - available only for ONLYOFFICE Enterprise Edition and ONLYOFFICE Developer Edition
  • onRequestCreateNew - the function called when the user is trying to create document by clicking the Create New button. This method is used instead of the createUrl field. If the method is not declared and the createUrl is not specified the Create New button will not be displayed.

    Example
    var onRequestCreateNew = function () {
        ...
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestCreateNew": onRequestCreateNew,
            ...
        },
        ...
    });
    
  • onRequestEditRights - the function called when the user is trying to switch the document from the viewing into the editing mode by clicking the Edit Document button. When the function is called, the editor must be initialized again, in editing mode. If the method is not declared the Edit button will not be displayed.

    onRequestEditRights parameter is obligatory when the editorConfig mode parameter is set to view and the permission to edit the document (document permissions) is set to true so that the user could switch to the editing mode.
    onRequestEditRights
    Example
    var onRequestEditRights = function () {
        console.log("ONLYOFFICE Document Editor requests editing rights");
        document.location.reload();
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestEditRights": onRequestEditRights,
            ...
        },
        ...
    });
    
  • onRequestHistory - the function called when the user is trying to show the document version history by clicking the Version History button.

    To show the document version history you must call the refreshHistory method. If the method and the onRequestHistoryData method is not declared the Version History button will not be displayed.

    onRequestHistory
    Example
    var onRequestHistory = function () {
        docEditor.refreshHistory({
            "currentVersion": 2,
            "history": [
                {
                    "created": "2010-07-06 10:13 AM",
                    "key": "af86C7e71Ca8",
                    "user": {
                        "id": "F89d8069ba2b",
                        "name": "Kate Cage"
                    },
                    "version": 1
                },
                {
                    "changes": changes,
                    "created": "2010-07-07 3:46 PM",
                    "key": "Khirz6zTPdfd7",
                    "serverVersion": serverVersion,
                    "user": {
                        "id": "78e1e841",
                        "name": "John Smith"
                    },
                    "version": 2
                },
                ...
            ]
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestHistory": onRequestHistory,
            ...
        },
        ...
    });
    

    Where the changes is the changes from the history object returned after saving the document.

    Where the serverVersion is the serverVersion from the history object returned after saving the document.

  • onRequestHistoryClose - the function called when the user is trying to go back to the document from viewing the document version history by clicking the Close History button. When the function is called, the editor must be initialized again, in editing mode. If the method is not declared the Close History button will not be displayed.

    onRequestHistoryClose
    Example
    var onRequestHistoryClose = function () {
        document.location.reload();
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestHistoryClose": onRequestHistoryClose,
            ...
        },
        ...
    });
    
  • onRequestHistoryData - the function called when the user is trying to click the specific document version in the document version history.

    The document version number is sent in the data parameter.

    To show the changes corresponding to the specific document version you must call the setHistoryData method. When calling this method, the token must be added to validate the parameters. If the method and the onRequestHistory method is not declared the Version History button will not be displayed.

    onRequestHistoryData
    Example
    var onRequestHistoryData = function (event) {
        var version = event.data;
        docEditor.setHistoryData({
            "changesUrl": "https://example.com/url-to-changes.zip",
            "fileType": "docx",
            "key": "Khirz6zTPdfd7",
            "previous": {
                "fileType": "docx",
                "key": "af86C7e71Ca8",
                "url": "https://example.com/url-to-the-previous-version-of-the-document.docx"
            },
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJjaGFuZ2VzVXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tY2hhbmdlcy56aXAiLCJmaWxlVHlwZSI6ImRvY3giLCJrZXkiOiJLaGlyejZ6VFBkZmQ3IiwicHJldmlvdXMiOnsiZmlsZVR5cGUiOiJkb2N4Iiwia2V5IjoiYWY4NkM3ZTcxQ2E4IiwidXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tdGhlLXByZXZpb3VzLXZlcnNpb24tb2YtdGhlLWRvY3VtZW50LmRvY3gifSwidXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tZXhhbXBsZS1kb2N1bWVudC5kb2N4In0.pfPJs9XvCmAnPiUnZYRm0rZGPYHzqfEP7AFRjKg1af4",
            "url": "https://example.com/url-to-example-document.docx",
            "version": version
        })
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestHistoryData": onRequestHistoryData,
            ...
        },
        ...
    });
    

    Where the changesUrl is the changesUrl from the JSON object returned after saving the document.

    Where the example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.

  • onRequestInsertImage - the function called when the user is trying to insert an image by clicking the Image from Storage button.

    The type of image insertion is specified in parameter data.c.

    To insert an image into the file you must call the insertImage method with the specified command. When calling this method, the token must be added to validate the parameters. If the method is not declared the Image from Storage button will not be displayed.

    onRequestInsertImage
    Example
    var onRequestInsertImage = function (event) {
        docEditor.insertImage({
            "c": event.data.c,
            "images": [
                {
            "fileType": "png",
                    "url": "https://example.com/url-to-example-image1.png"
                },
                {
                    "fileType": "png",
                    "url": "https://example.com/url-to-example-image2.png"
                },
                ...
            ],
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpbWFnZXMiOlt7ImZpbGVUeXBlIjoicG5nIiwidXJsIjoiaHR0cHM6Ly9leGFtcGxlLmNvbS91cmwtdG8tZXhhbXBsZS1pbWFnZTEucG5nIn0seyJmaWxlVHlwZSI6InBuZyIsInVybCI6Imh0dHBzOi8vZXhhbXBsZS5jb20vdXJsLXRvLWV4YW1wbGUtaW1hZ2UyLnBuZyJ9XX0.ly1O8-6u4Y7WJlgp9O-bJMeffHe0GtaXzyvY2UUFJTg"
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestInsertImage": onRequestInsertImage,
            ...
        },
        ...
    });
    
    Where the example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.
  • onRequestMailMergeRecipients - the function called when the user is trying to select recipients data by clicking the Mail merge button. Deprecated since version 7.5, please use onRequestSelectSpreadsheet instead.

  • onRequestOpen - the function called when the user is trying to open an external link by clicking the Open source button. If the method is not declared, this button will not be displayed.

    To open the editor with the external file referenced by the path or referenceData parameters in a new tab, you must pass a link to this tab by calling the window.open method with the path and windowName parameters.

    An object with the unique file data, the file path, and a new browser tab name are sent in the data parameter.

    open-source
    Example
    var onRequestOpen = function (event) {
        var path  = event.data.path;
        var referenceData = event.data.referenceData;
        var windowName  = event.data.windowName;
        window.open({
            "path": "https://example.com/external-url.docx",
            "windowName": event.data.windowName
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestOpen": onRequestOpen,
            ...
        },
        ...
    });
    
    Where the example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.
  • onRequestReferenceData - the function called when the user is trying to refresh data inserted from the external file by clicking the Update values button in the External links dialog box of the Data tab.

    An object with the unique file data from the source file, the file path or name, and the file URL are sent in the data parameter.

    To refresh data by a link to a file which is specified with the event parameters, you must call the setReferenceData method. When calling this method, the token must be added to validate the parameters. If the event is not declared, the Paste link and Update values buttons will not be displayed.

    To send the data to the setReferenceData method, it is recommended to search for the file by the referenceData parameter first. If there is no such a field or a file cannot be found, then the path or link parameters are used.
    Paste link
    Update values
    Example
    var onRequestReferenceData = function () {
        var link = event.data.link;
        var referenceData =  event.data.referenceData;
        var path = event.data.path;
        ...
    
        docEditor.setReferenceData({
            "fileType": "xlsx",
            "path": "sample.xlsx",
            "referenceData": {
                "fileKey": "BCFA2CED",
                "instanceId": "https://example.com",
                "key": "Khirz6zTPdfd7"
            },
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6Inhsc3giLCJwYXRoIjoic2FtcGxlLnhsc3giLCJyZWZlcmVuY2VEYXRhIjp7ImZpbGVLZXkiOiJCQ0ZBMkNFRCIsImluc3RhbmNlSWQiOiJodHRwczovL2V4YW1wbGUuY29tIn0sInVybCI6Imh0dHBzOi8vZXhhbXBsZS5jb20vdXJsLXRvLWV4YW1wbGUtZG9jdW1lbnQueGxzeCJ9.UXosmM-E_Cu9j9QGSlcj9FEoSu5m-zCS4b6FxO_2k7w",
            "url": "https://example.com/url-to-example-document.xlsx"
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestReferenceData": onRequestReferenceData,
            ...
        },
        ...
    });
    
  • onRequestReferenceSource - the function called when the user is trying to change a source of the external data by clicking the Change source button.

    An object with the unique file data and the file path or name are sent in the data parameter.

    When the button is clicked, you must call the setReferenceSource method to change a source of the external data. When calling this method, the token must be added to validate the parameters. If the event is not declared, the Change source button will not be displayed.

    To send the data to the setReferenceSource method, it is recommended to search for the file by the referenceData parameter first. If there is no such a field or a file cannot be found, then the path parameter is used. Change source
    Example
    var onRequestReferenceSource = function () {
        var referenceData =  event.data.referenceData;
        var path = event.data.path;
        ...
    
        docEditor.setReferenceSource({
            "fileType": "xlsx",
            "path": "sample.xlsx",
            "referenceData": {
                "fileKey": "BCFA2CED",
                "instanceId": "https://example.com",
                "key": "Khirz6zTPdfd7"
            },
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6Inhsc3giLCJwYXRoIjoic2FtcGxlLnhsc3giLCJyZWZlcmVuY2VEYXRhIjp7ImZpbGVLZXkiOiJCQ0ZBMkNFRCIsImluc3RhbmNlSWQiOiJodHRwczovL2V4YW1wbGUuY29tIn0sInVybCI6Imh0dHBzOi8vZXhhbXBsZS5jb20vdXJsLXRvLWV4YW1wbGUtZG9jdW1lbnQueGxzeCJ9.UXosmM-E_Cu9j9QGSlcj9FEoSu5m-zCS4b6FxO_2k7w",
            "url": "https://example.com/url-to-example-document.xlsx"
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestReferenceSource": onRequestReferenceSource,
            ...
        },
        ...
    });
    
  • onRequestRename - the function called when the user is trying to rename the file by clicking the Rename... button.

    Until version 6.0 the Rename... button is only available if the document.permissions.rename is set to true.
    onRequestRename
    Example
    var onRequestRename = function (event) {
        var title = event.data;
        ...
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestRename": onRequestRename,
            ...
        },
        ...
    });
    
  • onRequestRestore - the function called when the user is trying to restore the file version by clicking the Restore button in the version history.

    The document version number is sent in the data.version parameter if it is called for the document version from the history. Additionally, the document link is sent in the data.url parameter if it is called for the document changes from the history object. The type of the document which is specified with this link is sent in the data.fileType parameter.

    When the function is called, you must call the refreshHistory method to initialize version history again. If the method is not declared the Restore button will not be displayed.

    The Restore button is displayed for the previous document versions only and hidden for the current one. Until version 5.5 the Restore button is only available if the document.permissions.changeHistory is set to true.
    onRequestRestore
    Example
    var onRequestRestore = function (event) {
        var fileType = event.data.fileType;
        var url = event.data.url;
        var version = event.data.version;
        ...
        docEditor.refreshHistory({
            "currentVersion": 2,
            "history": [
                {
                    "created": "2010-07-06 10:13 AM",
                    "key": "af86C7e71Ca8",
                    "user": {
                        "id": "F89d8069ba2b",
                        "name": "Kate Cage"
                    },
                    "version": 1
                },
                {
                    "changes": changes,
                    "created": "2010-07-07 3:46 PM",
                    "key": "Khirz6zTPdfd7",
                    "serverVersion": serverVersion,
                    "user": {
                        "id": "78e1e841",
                        "name": "John Smith"
                    },
                    "version": 2
                },
                ...
            ]
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestRestore": onRequestRestore,
            ...
        },
        ...
    });
    

    Where the changes is the changes from the history object returned after saving the document.

    Where the serverVersion is the serverVersion from the history object returned after saving the document.

    Where the example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.

  • onRequestSaveAs - the function called when the user is trying to save file by clicking Save Copy as... button. The title of the document, its type and the absolute URL to the document to be downloaded are sent in the data parameter. If the method is not declared the Save Copy as... button will not be displayed.

    onRequestSaveAs
    Example
    var onRequestSaveAs = function (event) {
        var fileType = event.data.fileType;
        var title = event.data.title;
        var url = event.data.url;
        ...
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestSaveAs": onRequestSaveAs,
            ...
        },
        ...
    });
    
  • onRequestSelectDocument* - the function called when the user is trying to select a document for comparing or combining.

    The type of document selection is specified in the data.c parameter.

    To select a document for comparing or combining, you must call the setRequestedDocument method.

    * - available only for ONLYOFFICE Enterprise Edition and ONLYOFFICE Developer Edition onRequestSelectDocument
    Example
    var onRequestSelectDocument = function () {
        docEditor.setRequestedDocument({
            "c": event.data.c,
            "fileType": "docx",
            "url": "https://example.com/url-to-example-document.docx",
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6ImRvY3giLCJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL3VybC10by1leGFtcGxlLWRvY3VtZW50LmRvY3gifQ.t8660n_GmxJIppxcwkr_mUxmXYtE8cg-jF2cTLMtuk8"
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestSelectDocument": onRequestSelectDocument,
            ...
        },
        ...
    });
    
    Where the example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.
  • onRequestSelectSpreadsheet - the function called when the user is trying to select recipients data by clicking the Mail merge button.

    The type of spreadsheet selection is specified in the data.c parameter.

    To select recipient data, you must call the setRequestedSpreadsheet method. When calling this method, the token must be added to validate the parameters. If the method is not declared, the Mail merge button will become faded and unclickable.

    onRequestMailMergeRecipients
    Example
    var onRequestSelectSpreadsheet = function () {
        docEditor.setRequestedSpreadsheet({
            "c": event.data.c,
            "fileType": "xlsx",
            "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJmaWxlVHlwZSI6Inhsc3giLCJ1cmwiOiJodHRwczovL2V4YW1wbGUuY29tL3VybC10by1leGFtcGxlLXJlY2lwaWVudHMueGxzeCJ9.P3TjOyX1Tv3xAVRAc8qtNb-uFLD6FH_WErag_rbI6nQ",
            "url": "https://example.com/url-to-example-recipients.xlsx"
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestSelectSpreadsheet": onRequestSelectSpreadsheet,
            ...
        },
        ...
    });
    
    Where the example.com is the name of the server where document manager and document storage service are installed. See the How it works section to find out more on Document Server service client-server interactions.
  • onRequestSendNotify - the function called when the user is mentioned in a comment.

    The message and the list of emails is sent in the data parameter. The comment data is received in the data.actionLink parameter and must be then used in the configuration as the value for the editorConfig.actionLink parameter.

    The list of users to be mentioned should be completed by setUsers method.

    In version 5.4, onRequestSendNotify event can only be used if onRequestUsers event is set. Starting from version 5.5, there is no such dependency between onRequestSendNotify and onRequestUsers - both can be set independently.
    Example
    var onRequestSendNotify = function (event) {
        var ACTION_DATA = event.data.actionLink;
        var comment = event.data.message;
        var emails = event.data.emails;
        ...
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestSendNotify": onRequestSendNotify,
            ...
        },
        ...
    });
    
  • onRequestSharingSettings - the function called when the user is trying to manage document access rights by clicking Change access rights button.

    When the access rights is changed, you must call the setSharingSettings method to update the information about the settings which allow to share the document with other users. If the method is not declared the Change access rights button will not be displayed.

    onRequestSharingSettings
    Example
    var onRequestSharingSettings = function () {
        docEditor.setSharingSettings({
            "sharingSettings": [
                {
                    "permissions": "Full Access",
                    "user": "John Smith"
                },
                {
                    "isLink": true,
                    "permissions": "Read Only",
                    "user": "External link"
                }
            ]
        });
        ...
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestSharingSettings": onRequestSharingSettings,
            ...
        },
        ...
    });
    
  • onRequestUsers - the function called when the user can select other users to mention in the comments, grant the access rights to edit the specific sheet ranges, or set the user avatars.

    Starting from version 7.4, the operation type can be specified in the data.c parameter. It can take two values - mention or protect. Prior to version 7.4, only the mention operation was available with this event.

    Starting from version 8.0, the info operation type is added to set the avatars for the users with the ids specified in the data.id parameter.

    To set a list of users, you must call the setUsers method which can take different lists of users depending on the specified operation type. The onRequestUsers event is called once for each c type when the corresponding operation is performed. If the setUsers is called with an empty list, then the onRequestUsers event will fire again.

    onRequestUsers
    Protect range
    Example
    var onRequestUsers = function (event) {
        var c = event.data.c;
        var id = event.data.id;
        ...
    
        docEditor.setUsers({
            "c": event.data.c,
            "users": [
                {
                    "email": "john@example.com",
                    "id": "78e1e841",
                    "image": "https://example.com/url-to-user-avatar1.png",
                    "name": "John Smith"
                },
                {
                    "email": "kate@example.com",
                    "id": "F89d8069ba2b",
                    "image": "https://example.com/url-to-user-avatar2.png",
                    "name": "Kate Cage"
                },
                ...
            ]
        });
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onRequestUsers": onRequestUsers,
            ...
        },
        ...
    });
    
  • onWarning - the function called when a warning occurs. The warning message is sent in the data parameter. A list of error codes can be found here.

    Example
    var onWarning = function (event) {
        console.log("ONLYOFFICE Document Editor reports a warning: code " + event.data.warningCode + ", description " + event.data.warningDescription);
    };
    
    var docEditor = new DocsAPI.DocEditor("placeholder", {
        "events": {
            "onWarning": onWarning,
            ...
        },
        ...
    });