web share api 可通过调用设备原生分享功能实现网页内容分享。1. 检测浏览器支持：使用 navigator.share 判断；2. 基本用法：通过 navigator.share({title, text, url}) 分享链接、标题和文本；3. 进阶用法：结合 file 对象和 navigator.canshare() 实现文件分享；4. 兼容性处理：提供备选方案如自定义分享菜单；5. 最佳实践：结合 pwa 和 service worker 提升用户体验，如显示预览界面或自定义分享选项。
Web Share API 让你能直接从网页触发设备原生的分享功能，不用自己写复杂的分享逻辑，省事儿！简单来说，就是一键调用手机或电脑自带的分享菜单。
使用 Web Share API，可以方便地将链接、文本甚至文件分享到社交媒体、邮件或者其他应用。
如何检测浏览器是否支持 Web Share API？
在使用 Web Share API 之前，先要检查浏览器是否支持。可以用 navigator.share 来判断：
立即学习“前端免费学习笔记（深入）”；
if (navigator.share) { console.log('Web Share API is supported.'); } else { console.log('Web Share API is not supported.'); }
分享链接、标题和文本的基本用法
最简单的用法就是分享链接、标题和文本。看下面的代码：
async function sharedata() { const shareData = { title: 'MDN Web Docs', text: 'Learn web development on MDN!', url: 'https://developer.mozilla.org', }; try { await navigator.share(shareData); console.log('分享成功'); } catch (err) { console.log('分享失败:', err.message); } } // 绑定到按钮点击事件 document.querySelector('button').addEventListener('click', shareData);
这段代码定义了一个 shareData 函数，它会创建一个包含 title、text 和 url 属性的对象，然后调用 navigator.share() 方法。注意，navigator.share() 是一个异步函数，所以要用 await 等待它完成。如果分享成功，控制台会输出“分享成功”，否则会输出错误信息。
分享文件：进阶用法和注意事项
除了分享链接和文本，Web Share API 还能分享文件。这需要用到 File 对象和 type 属性。
async function shareFiles(filesArray) { if (!navigator.canShare) { console.log('不支持分享文件'); return; } const shareData = { files: filesArray, title: '分享文件', text: '看看这些文件怎么样？', }; try { await navigator.share(shareData); console.log('文件分享成功'); } catch (err) { console.log('文件分享失败:', err.message); } } // 示例： const fileInput = document.querySelector('input[type="file"]'); fileInput.addEventListener('change', async (event) => { const files = Array.from(event.target.files); await shareFiles(files); });
这里，filesArray 是一个包含 File 对象的数组。navigator.canShare() 方法用于检查是否可以分享这些文件。注意，分享文件时，浏览器可能会有一些限制，比如文件大小和类型。
解决 Web Share API 兼容性问题
虽然 Web Share API 越来越普及，但还是有些浏览器不支持。为了解决兼容性问题，可以提供一个备选方案，比如使用第三方的分享库或者显示一个自定义的分享菜单。
async function shareData() { if (navigator.share) { try { await navigator.share({ title: 'MDN Web Docs', text: 'Learn web development on MDN!', url: 'https://developer.mozilla.org', }); console.log('分享成功'); } catch (err) { console.log('分享失败:', err.message); } } else { // 提供备选方案，比如显示自定义分享菜单 showCustomShareMenu(); } }
为什么 navigator.canShare() 返回 false？
navigator.canShare() 返回 false 的原因有很多，常见的包括：
- 浏览器不支持： 某些旧版本的浏览器可能不支持 navigator.canShare() 方法。
- 文件类型不支持： 浏览器可能不支持分享某些类型的文件。
- 文件大小超出限制： 浏览器对分享的文件大小有限制。
- 缺少必要的权限： 某些情况下，可能需要用户授权才能分享文件。
- 安全上下文： Web Share API 通常需要在安全上下文（HTTPS）下才能使用。
Web Share API 在实际项目中的最佳实践
在实际项目中，可以结合 Web Share API 和 Progressive web app (PWA) 技术，提供更好的用户体验。例如，可以在 PWA 中使用 Web Share API，让用户更方便地分享内容。同时，可以结合 Service Worker 技术，实现离线分享功能。
另外，为了提高用户体验，建议在分享之前显示一个预览界面，让用户确认分享的内容。还可以提供一些自定义的分享选项，比如选择分享到特定的社交媒体平台。
