作为开发人员，经常使用 Web API 来轻松实现复杂的功能，或者创建它们来抽象复杂性。Web API 允许服务之间进行对话，分享信息到朋友圈或显示地图等操作。

可以将用于构建客户端 Web 应用程序的 Web API 分为两类：

• 浏览器API：是 JavaScript 可以正常使用的 API，允许开发人员轻松实现功能。 例如 DOM、Fetch、音频、视频、WebGL、notifications 等等
• 第三方开发API ：这些接口通常不是内置在浏览器中的，但是由第三方平台提供的在特定环境中可以使用的API，如微信、微博分享等等

下面总结Web项目中经常接触到的API：

• 地理位置API：允许访问检索主机设备的位置信息
• 文档对象模型API：DOM 是 HTML 文档的 API，它是 JavaScript 和 HTML 文档之间的接口，有着大量的接口列表，例如 Document对象接口、Window对象接口等
• 历史记录API：在大多数路由器实现中都是抽象的。该 API 能够跟踪和修改浏览器的 URL 和历史记录，以及通过 JavaScript 访问浏览历史
• 画布API：允许通过使用 <canvas> 元素在页面上显示不同的视觉图形，对于HTML游戏和图表很有用
• 动画API：支持在页面上进行协调的视觉更改，它结合了CSS过渡/动画和基于javascript的动画的优点。

在本文中，将探索一些提供移动友好功能的API，包括从社交媒体分享和剪贴板操作到联系选择器、语音和通知功能相关的内容。下面就来总结一下移动WEB的开发常用的API。

分享API

可以在网站上实现共享功能，它给人一种移动本地共享的感觉，可以共享文本、文件和设备上其他应用程序的链接。

可以通过 navigator.share 方法访问：

if (navigator.share) {
    navigator
        .share({
            title: "DevPoint开发技能分析",
            text: "WEB开发技能分析总结",
            url: "https://www.devpoint.cn",
        })
        .then(() => console.log("分享成功"))
        .catch((error) => console.log("分享失败", error));
}

上面的代码片段实现了如何使用普通的JavaScript共享文本，下面定义一个方法，返回按钮并完成绑定 onclick 事件：

import React from "react";
function ShareButton({ label, text, title }) {
    const shareDetails = { title, text };

    const handleSharing = async () => {
        if (navigator.share) {
            try {
                await navigator
                    .share(shareDetails)
                    .then(() => console.log("分享成功"));
            } catch (error) {
                console.log(`分享失败：${error}`);
            }
        } else {
            console.log("此浏览器目前不支持");
        }
    };
    return (
        <button onClick={handleSharing}>
            <span>{label}</span>
        </button>
    );
}
export default ShareButton;

联系选择器API

大多数移动应用程序可能都会涉及访问联系人信息，可以使用 navigator.contacts 实现，它接受两个参数：属性、一个包含要访问的属性的数组和选项。

const props = ["name", "tel"];
const opts = { multiple: true };

async function getContacts() {
    try {
        const contacts = await navigator.contacts.select(props, opts);
        handleResults(contacts);
    } catch (ex) {
        // 错误
    }
}

剪切板API

剪贴板操作，如复制、剪切和粘贴，是移动应用程序中最常见的功能。剪贴板API允许web用户访问系统剪贴板并执行基本的剪贴板操作。

过去可以使用 DOM 对象的 document.execCommand 与系统剪贴板进行交互。但是，最新的异步剪贴板 API 提供了直接读取和写入剪贴板内容的访问权限，更加详细的介绍可以参阅《WEB 剪切板操作navigator.clipboard的使用》。

语音API

如今，大多数移动应用程序都加入了语音识别和文本转换语音功能，以改善易用性和用户体验，语音API为浏览器带来了这些功能。在本文中，只讨论语音识别 SpeechRecognition 接口，使用语音识别接口进行语音识别，使用设备默认的语音识别系统：

const SpeechRecognition = SpeechRecognition || webkitSpeechRecognition;
const recognition = new SpeechRecognition(); // new SpeechRecognition object
recognition.continuous = false;
recognition.lang = "cn-ZH";
recognition.interimResults = false;

recognition.onstart = function () {
    console.log("请对着麦克风说话");
};

recognition.onspeechend = function () {
    // 当用户完成说话
    recognition.stop();
};

// 当语音识别服务返回结果时运行
recognition.onresult = function (event) {
    var transcript = event.results[0][0].transcript;
    var confidence = event.results[0][0].confidence;
};

// 开始识别
recognition.start();

通知API

Notification API经常与Push API互换，但它们是不同的。Notification API 的目标是向用户显示信息，而Push API允许 service worker 处理来自服务器的推送消息，即使设备处于非活动状态。

现在博客和Web应用广泛使用这种方法，当服务有变化或更新时通知用户。这个API的一个常见情况是，当的应用程序是PWA，需要用户刷新浏览器以获得新的应用程序更新。

JavaScript 有一个 Notification 构造函数：

const message = "升级获取新功能";
const notification = new Notification("保存PWA应用", { body: text });

总结

在本文中，简单总结了一下Web项目开发常用的API及移动应用开发相关的API。