afterUploadFile

2.2.0 버전부터 지원합니다.

파일 업로드가 완료된 후에 발생합니다.

이벤트 등록: API 사용

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';
var editor = new SynapEditor(editorId, editorConfig, html);

editor.setEventListener('afterUploadFile', function (e) {
});

이벤트 등록: 함수 방식

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';

function SynapEditorAfterUploadFile(e) {
}

new SynapEditor(editorId, editorConfig, html);

이벤트 등록: 에디터 초기화 시 등록

var editorId = 'synapEditor';
var editorConfig = {};
var html = '';
var eventListeners = {
    afterUploadFile: function (e) {
    }
};

new SynapEditor(editorId, editorConfig, html, eventListeners);

함수에 전달된 객체의 Shape

함수에 전달되는 매개변수 e의 형태는 다음과 같습니다.

// release 2.2.0
e = {
    editor: SynapEditor,
    eventType: 'afterUploadFile',
    cancelable: false,
    returnValue: null,
    path: '/upload/path/filename.zip'    // Uploaded path
}

// release 2.2.1 and above
e = {
    editor: SynapEditor,
    eventType: 'afterUploadFile',
    cancelable: false,
    returnValue: null,
    fileType: 'file',                    // [2.2.1] File type
    path: '/upload/path/filename.zip'
}

// release 2.10.0 and above
e = {
    editor: SynapEditor,
    eventType: 'afterUploadFile',
    cancelable: false,
    returnValue: null,
    fileType: 'file',
    path: '/upload/path/filename.zip',
    responseData: {}                     // [2.10.0] Full response information
}

// release 2.15.0 and above
e = {
    editor: SynapEditor,
    eventType: 'afterUploadFile',
    cancelable: false,
    returnValue: null,
    fileType: 'file',
    path: '/upload/path/filename.zip',
    responseData: {},
    error: undefined                     // [2.15.0] Error information when upload fails
}

파일 업로드 실패

2.15.0 버전부터 지원합니다.

릴리즈 2.15.0부터, 업로드가 실패할 때도 afterUploadFile 이벤트가 발생합니다.

업로드가 실패하면 Error 객체가 afterUploadFile 이벤트 객체의 error 속성에 담깁니다.

업로드에 실패했을 때 알림을 표시하는 예시:

editor.setEventListener('afterUploadFile', function (e) {
    if (e.error && e.error.status === 500) {
        e.editor.execCommand('showDialog', 'alert', 'File upload failed.');
    }
});