cbb
261caf50b7
R4 外提 scope/ota/seq/conn-poll；R5 waitVersion/queryNodeIdParam 下沉 transport；R6 ecat-bus 单点 bootstrap；R7 toast-stack + utils 去重。 main.js 4647→~1894 行。?v= 已 bump 20260924a。
108 lines
4.1 KiB
JavaScript
108 lines
4.1 KiB
JavaScript
/**
|
||
* utils.js - 通用工具函数
|
||
*
|
||
* 格式化 / 转义工具函数，供各子模块和 can.js / can_monitor.js 共享。
|
||
*/
|
||
// ==================== 工具函数 ====================
|
||
/** @description 格式化字节大小为人类可读字符串（B/KB/MB）。 */
|
||
/** @description 字节格式化为 B / KB（不升到 MB，避免 1024KB 显示成 1.00MB）。 */
|
||
export function formatBytes(bytes) {
|
||
if (!Number.isFinite(bytes) || bytes < 0) return '--';
|
||
if (bytes < 1024) return bytes + ' B';
|
||
var kb = bytes / 1024;
|
||
if (Math.abs(kb - Math.round(kb)) < 1e-9) return Math.round(kb) + ' KB';
|
||
return kb.toFixed(1) + ' KB';
|
||
}
|
||
/** @description 格式化 Date 对象为 HH:MM:SS.mmm 时间字符串。 */
|
||
export function formatTime(date) {
|
||
var h = String(date.getHours()).padStart(2, '0');
|
||
var m = String(date.getMinutes()).padStart(2, '0');
|
||
var s = String(date.getSeconds()).padStart(2, '0');
|
||
var ms = String(date.getMilliseconds()).padStart(3, '0');
|
||
return h + ':' + m + ':' + s + '.' + ms;
|
||
}
|
||
/** @description 格式化秒数为人类可读运行时间（d/h/m/s）。 */
|
||
export function formatUptime(sec) {
|
||
if (!Number.isFinite(sec) || sec < 0) return '--';
|
||
const d = Math.floor(sec / 86400);
|
||
const h = Math.floor((sec % 86400) / 3600);
|
||
const m = Math.floor((sec % 3600) / 60);
|
||
const s = Math.floor(sec % 60);
|
||
if (d > 0) return d + 'd ' + h + 'h ' + m + 'm';
|
||
if (h > 0) return h + 'h ' + m + 'm ' + s + 's';
|
||
if (m > 0) return m + 'm ' + s + 's';
|
||
return s + 's';
|
||
}
|
||
/** @description 转义 HTML 特殊字符，防止 XSS 注入。 */
|
||
export function escapeHtml(text) {
|
||
return String(text == null ? '' : text)
|
||
.replace(/&/g, '&')
|
||
.replace(/</g, '<')
|
||
.replace(/>/g, '>')
|
||
.replace(/"/g, '"')
|
||
.replace(/'/g, ''');
|
||
}
|
||
/**
|
||
* @description 将字节数组（Uint8Array 或 ArrayBuffer）转为小写 hex 字符串。
|
||
* SHA-256 等哈希显示前需要 toUpperCase()。
|
||
* @param {Uint8Array|ArrayBuffer} bytes
|
||
* @returns {string}
|
||
*/
|
||
export function bytesToHex(bytes) {
|
||
var arr = bytes instanceof Uint8Array ? bytes : new Uint8Array(bytes);
|
||
var out = '';
|
||
for (var i = 0; i < arr.length; i++) {
|
||
var h = arr[i].toString(16);
|
||
if (h.length < 2) h = '0' + h;
|
||
out += h;
|
||
}
|
||
return out;
|
||
}
|
||
|
||
/**
|
||
* @description 当前是否有刷写/OTA 在跑（跨 iframe 共享）。
|
||
* 多 iframe 保活外壳下各功能页是**独立文档**，window 变量不通用（刷写页的
|
||
* window.bootEcatBusy 在 CAN 页里读不到），所以走 localStorage 这一条共享通道：
|
||
* 刷写方（js/ota/boot_ecat.js）写 dcu_flash_busy_until = 预计结束时刻(ms)，
|
||
* 轮询方据此避让。带到期时间，页面中途关掉/异常也不会把标记永久挂住。
|
||
* @returns {boolean} 刷写窗口内为 true
|
||
*/
|
||
export function flashBusyNow() {
|
||
try {
|
||
var until = parseInt(localStorage.getItem('dcu_flash_busy_until'), 10);
|
||
return Number.isFinite(until) && until > Date.now();
|
||
} catch (_) {
|
||
return false;
|
||
}
|
||
}
|
||
|
||
/** @description 写前比较的 textContent 更新：值未变则不碰 DOM。 */
|
||
export function setTextIfChanged(el, txt) {
|
||
if (el && el.textContent !== txt) el.textContent = txt;
|
||
}
|
||
/** @description 写前比较的 className 更新。 */
|
||
export function setClassIfChanged(el, cls) {
|
||
if (el && el.className !== cls) el.className = cls;
|
||
}
|
||
/** @description 写前比较的 style[prop] 更新。 */
|
||
export function setStyleIfChanged(el, prop, v) {
|
||
if (el && el.style && el.style[prop] !== v) el.style[prop] = v;
|
||
}
|
||
/** @description classList.toggle 前比较，避免无谓样式失效。 */
|
||
export function toggleClsIfChanged(el, cls, on) {
|
||
if (!el) return;
|
||
var has = el.classList.contains(cls);
|
||
if (has !== !!on) el.classList.toggle(cls, !!on);
|
||
}
|
||
|
||
/**
|
||
* @description 无设备静默态：给 <html> 挂 data-dcu-calm，由 responsive.css 掐动画。
|
||
* 全仓唯一实现（connection.js / motor main 均 import 此处）。
|
||
*/
|
||
export function setQuietMode(quiet) {
|
||
var v = quiet ? '1' : '0';
|
||
if (document.documentElement.dataset.dcuCalm !== v) {
|
||
document.documentElement.dataset.dcuCalm = v;
|
||
}
|
||
}
|