Function startTransferProgress

public/js/transferProgress.js:827–872

(opts = {})

}

export function startTransferProgress(opts = {}) {
  ensureUi();

  const job = {
    id: ++_seq,
    action: String(opts.action || 'Transferring'),
    itemCount: Number.isFinite(opts.itemCount) ? opts.itemCount : 0,
    itemLabel: opts.itemLabel ? String(opts.itemLabel) : 'items',
    totalBytes: Number.isFinite(opts.totalBytes) ? opts.totalBytes : 0,
    source: opts.source ? String(opts.source) : '',
    destination: opts.destination ? String(opts.destination) : '',
    title: opts.title ? String(opts.title) : '',
    subText: opts.subText ? String(opts.subText) : '',
    startedAt: Date.now(),
    endedAt: 0,
    showAt: Date.now() + TRANSFER_UI_DELAY_MS,
    shown: false,
    estimateBps: readStoredSpeed(),
    indeterminate: false,
    state: String(opts.state || 'running').toLowerCase(),
    error: '',
    removeAt: 0,
    dismissed: false,
    mode: 'estimate',
    pct: null,
    bytesDone: null,
    bytesTotal: null,
    filesDone: null,
    filesTotal: null,
    current: '',
    lastProgressAt: Date.now(),
    renderedPct: null,
    cancelable: !!opts.cancelable && typeof opts.onCancel === 'function',
    onCancel: (typeof opts.onCancel === 'function') ? opts.onCancel : null,
    cancelInFlight: false,
    cancelRequested: false
  };

  const bytesKnown = opts.bytesKnown !== false;
  job.indeterminate = !!opts.indeterminate || !bytesKnown || job.totalBytes <= 0;

  _jobs.set(job.id, job);
  ensureTicking();
  renderAll();
  return job;
}

export function updateTransferProgress(jobRef, updates = {}) {
  const job = resolveJob(jobRef);