PWA如何实现离线XML数据暂存和后台上传

Service Worker需显式缓存XML请求,因浏览器不自动缓存;离线时须用response.text()获取字符串再用DOMParser解析;后台上传XML需结合Background Sync与IndexedDB持久化,并注意编码声明与Content-Type匹配。

pwa如何实现离线xml数据暂存和后台上传

Service Worker 中拦截并缓存 XML 请求

XML 数据通常通过 fetch() 发起(如 fetch('/api/data.xml')),要离线可用,必须在 Service Worker 的 installfetch 事件中显式缓存。不能依赖 Cache-Control 响应头自动缓存——浏览器默认不缓存非 GET 或非可缓存 MIME 类型的请求,而很多服务器返回 XML 时未设 Content-Type: application/xmltext/xml,导致缓存失败。

推荐在 fetch 事件中按 URL 模式或响应头判断后主动存入 Cache API:

self.addEventListener('fetch', event => {
  const { request } = event;
  if (request.destination === 'xml' || request.url.endsWith('.xml')) {
    event.respondWith(
      caches.open('xml-cache').then(cache =>
        cache.match(request).then(cached => {
          if (cached) return cached;
          return fetch(request).then(response => {
            // 确保响应可被缓存:需是 200 且有合法 Content-Type
            if (response.status === 200 && 
                (response.headers.get('content-type')?.includes('xml') || 
                 request.url.endsWith('.xml'))) {
              cache.put(request, response.clone());
            }
            return response;
          });
        })
      )
    );
  }
});

离线时读取缓存 XML 并解析为 DOM

XML 缓存后,前端 JS 无法直接用 DOMParser 解析 Response 对象;必须先调用 response.text() 获取字符串,再手动解析。常见错误是直接传 responsenew DOMParser().parseFromString(),结果得到空文档。

正确流程:

  • caches.match() 获取缓存的 Response
  • 调用 response.text() 得到 XML 字符串(注意:必须 await)
  • new DOMParser().parseFromString(xmlStr, 'application/xml') 解析
  • 检查 parsererror 元素判断是否解析失败(XML 格式错误时浏览器会注入该节点)

示例片段:

async function loadCachedXML(url) {
  const cache = await caches.open('xml-cache');
  const response = await cache.match(url);
  if (!response) throw new Error('XML not found in cache');
  
  const xmlText = await response.text();
  const parser = new DOMParser();
  const xmlDoc = parser.parseFromString(xmlText, 'application/xml');
  
  if (xmlDoc.querySelector('parsererror')) {
    throw new Error('Invalid XML structure');
  }
  return xmlDoc;
}

后台静默上传 XML 数据(使用 Background Sync)

用户提交 XML 数据(如表单导出、日志打包)后,若网络不可用,需暂存并等恢复后自动上传。不能只靠 fetch() 重试——页面关闭后 JS 停止执行。必须用 backgroundSync 配合 IndexedDB 持久化待上传数据。

PhotoScissors

PhotoScissors

免费自动图片背景去除

下载

关键点:

  • Service Worker 必须在 register() 后启用 backgroundSync 功能(Chrome ≥ 49,需 HTTPS)
  • 上传任务注册前,XML 内容必须先存入 IndexedDB(不能存 BlobFile,要转为 stringUint8Array
  • sync 事件触发时,从 DB 读取一条未上传的 XML 记录,用 fetch() 提交,成功后标记为已上传
  • 避免重复上传:每条记录加唯一 iduploaded: boolean 字段

注册 sync 的典型调用:

// 在主页面中
if ('serviceWorker' in navigator && 'sync' in ServiceWorkerRegistration.prototype) {
  navigator.serviceWorker.ready.then(reg => {
    reg.sync.register('upload-xml-pending');
  });
}

IndexedDB 存储 XML 字符串的注意事项

XML 数据常含特殊字符、命名空间、CDATA 段,直接存字符串最稳妥。不要尝试序列化为 JSON 包裹(会丢失格式细节),也不要存 XMLDocument 实例(无法结构化克隆)。

存储建议:

  • 字段设计至少包含:id(UUID)、xmlContent(string)、url(目标接口)、method(通常 POST)、headers(JSON string)、uploaded(boolean)
  • 使用 transaction(..., 'readwrite') 确保写入原子性
  • 上传成功后,在 sync 回调里用 IDBKeyRange.only(id) 精确删除或更新记录
  • 避免在大量 XML 场景下阻塞主线程:用 indexedDB.open()onupgradeneeded 做 schema 初始化,后续操作全走异步事务

真正容易被忽略的是:XML 中的编码声明(如 )必须与实际内容一致,否则后台服务解析失败——前端存之前不必移除它,但需确保 fetch() 提交时设置 headers: {'Content-Type': 'application/xml; charset=UTF-8'},否则某些后端(如 Java Spring)会按 ISO-8859-1 解析。

https://www.php.cn/faq/2030856.html

发表回复

Your email address will not be published. Required fields are marked *