0

0

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

星降

星降

发布时间:2026-01-26 07:31:36

|

698人浏览过

|

来源于php中文网

原创

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 持久化待上传数据。

Otter.ai
Otter.ai

一个自动的会议记录和笔记工具,会议内容生成和实时转录

下载

关键点:

  • 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 中的编码声明(如 <?xml version="1.0" encoding="UTF-8"?>)必须与实际内容一致,否则后台服务解析失败——前端存之前不必移除它,但需确保 fetch() 提交时设置 headers: {'Content-Type': 'application/xml; charset=UTF-8'},否则某些后端(如 Java Spring)会按 ISO-8859-1 解析。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

161

2025.08.06

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

89

2026.01.26

json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

457

2023.08.07

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

549

2023.08.23

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

337

2023.10.13

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

82

2025.09.10

chrome什么意思
chrome什么意思

chrome是浏览器的意思,由Google开发的网络浏览器,它在2008年首次发布,并迅速成为全球最受欢迎的浏览器之一。本专题为大家提供chrome相关的文章、下载、课程内容,供大家免费下载体验。

1064

2023.08.11

chrome无法加载插件怎么办
chrome无法加载插件怎么办

chrome无法加载插件可以通过检查插件是否已正确安装、禁用和启用插件、清除插件缓存、更新浏览器和插件、检查网络连接和尝试在隐身模式下加载插件方法解决。更多关于chrome相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

843

2023.11.06

TypeScript类型系统进阶与大型前端项目实践
TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开,深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析,帮助开发者构建类型安全、结构清晰、易维护的前端工程体系,提高团队协作效率与代码质量。

26

2026.03.13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Kotlin 教程
Kotlin 教程

共23课时 | 4.4万人学习

C# 教程
C# 教程

共94课时 | 11.3万人学习

Java 教程
Java 教程

共578课时 | 82万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号