Upload

upload:before:send#

Handlers may return a modified payload object.

Type: hook (handler may return a value).

Payload:

• data — upload body (FormData or fields)
• files — files being uploaded
• event — native change/drop event
• uploader — Uploader instance

Example:

app.on('upload:before:send', ({ data, files }) => {
  if (!files.length) return { cancel: true };
  data.append('source', 'redactor');
  return { data, files };
});

upload:error#

Emitted when an error occurs in the upload flow.

Type: signal.

Payload:

• response — error response from the server
• event — native upload event
• uploader — Uploader instance

Example:

app.on('upload:error', ({ response }) => {
  toast.show(response?.message || 'Upload failed');
});

upload:success#

Emitted when a file upload succeeds.

Type: signal.

Payload:

• response — parsed server response (URLs, ids, …)
• event — native upload event
• uploader — Uploader instance

Example:

app.on('upload:success', ({ response }) => {
  insertUploadedFile(response.url);
});