AcroForm JavaScript Promise 对象应用示例: 异步加载PDF文件

这段代码演示了在Adobe Acrobat DC Pro 的 JavaScript 环境中如何使用 Promise 对象处理异步操作。具体功能是：

定义了一个loadFile函数，模拟异步加载PDF文件的操作
使用Promise对象封装异步操作，提供成功(resolve)和失败(reject)两种状态
通过.then()处理加载成功的情况，.catch()处理加载失败的情况
模拟了2秒的加载延迟

应用场景

在Adobe Acrobat DC Pro中，这种模式可以应用于：

异步加载PDF文档或附件
处理表单数据提交
执行需要等待的用户交互
管理多个异步操作的顺序执行

无效有效是否开始调用 loadFile函数参数验证立即 reject 错误启动进度模拟设置定时器模拟加载加载成功? resolve 成功结果 reject 错误 then 处理成功 catch 处理错误 finally 清理结束

流程图说明:

流程从调用loadFile函数开始
首先进行参数验证，失败则立即拒绝
参数有效则启动进度模拟和加载过程
加载完成后根据结果决定是resolve还是reject
最终都会执行finally中的清理代码

以下是代码:

javascript 复制代码

/**
 * 模拟异步加载PDF文件
 * @param {string} filePath - 要加载的文件路径
 * @param {number} [delay=2000] - 模拟延迟时间(毫秒)
 * @returns {Promise} 返回一个Promise对象
 */
function loadFile(filePath, delay = 2000) {
  return new Promise((resolve, reject) => {
    // 添加参数验证
    if (!filePath || typeof filePath !== 'string') {
      reject(new Error('无效的文件路径'));
      return;
    }
    
    // 模拟进度更新
    let progress = 0;
    const interval = setInterval(() => {
      progress += 10;
      console.log(`加载进度: ${progress}%`);
      if (progress >= 90) clearInterval(interval);
    }, delay/10);
    
    // 模拟文件加载
    setTimeout(() => {
      // 90%成功率
      if (Math.random() > 0.1) {
        clearInterval(interval);
        console.log(`加载进度: 100%`);
        resolve({
          success: true,
          message: `文件 ${filePath} 加载成功`,
          path: filePath
        });
      } else {
        clearInterval(interval);
        reject(new Error(`文件 ${filePath} 加载失败: 连接超时`));
      }
    }, delay);
  });
}

// 使用示例
loadFile("example.pdf", 1500)
  .then((result) => {
    console.log(result.message); 
    // 这里可以继续处理加载成功后的文件数据
    app.alert(result.message, 3);
  })
  .catch((error) => {
    console.error(error.message);
    // 这里可以进行错误处理
    app.alert(error.message, 1);
  })
  .finally(() => {
    console.log("文件加载操作完成");
    // 无论成功失败都会执行的清理操作
  });