/** * 远程脚本加载器(框架无关)。 * * 用途:把一段**运行时才拿到**的 IIFE 脚本加载进页面。典型消费方式是 * 「脚本把配置类挂到 window 上,宿主组件取出来交给表格渲染」。 * * ## 三条用血换来的约定 * * 1. **缓存 key 必须是 `url`,不能是业务上的名字。** * 脚本内容由 url 决定。若用名字做 key,就会出现「改了 url、名字没变」 * 时命中旧 Promise、新脚本**永远不会加载**的情况,而且完全静默。 * 2. **加载失败必须把条目从缓存里摘掉。** * 否则重试永远拿到那个失败的 Promise,表现为「怎么点都没反应」。 * 3. **url 里的文件名要过白名单。** * 它最终会被拼进 `script.src`,是本模块唯一的注入面。 * * 本模块不依赖 vue,可单独在任意环境使用,也便于写单测。 */ /** 脚本文件名白名单:字母 / 数字 / 点 / 下划线 / 短横线 */ export declare const SAFE_SCRIPT_PATH: RegExp; /** * 拼接脚本地址:`baseUrl + "/" + path + ".js"`。 * * `path` 不允许出现路径分隔符(`/`、`\`)或 `..`,避免越出 `baseUrl` 指定的目录。 * 校验不过直接抛错,由调用方决定怎么呈现 —— 不要静默降级成一个错误的地址。 */ export declare const resolveScriptUrl: (baseUrl: string, path: string) => string; /** * 加载脚本。同一个 url 只会真正插入一次 `